Get the list of IPv4 and IPv6 prefixes of the AS number given.
GET {{baseUrl}}/v1/asn/:number/prefixes
What
Obtain the full list of IPv4 and IPv6 prefixes of the Autonomous System Number (ASN) passed as a parameter.
Parameters
The endpoint accepts only the following parameter in the path:
- number
: (Mandatory) The ASN number to be queried.
Result
The result is a JSON object with the following structure:
- self
: the URI of the API call
- asn
: the URI to query the full details of the ASN.
- prefixes_v4
: the list of IPv4 prefixes that belong to the ASN. Each element of the list is a JSON object with the following structure:
- self
: the URI to individual IPv4 prefix.
- asn
: the URI to query the full details of the ASN.
- object_type
: the type of the prefix. The allowed values are: IPv4.
- maintainer
: the information about the maintainer of this prefix in the registry.
- description
: the description of the prefix as registered in the registry.
- registry_date
: the date of registration of the prefix in the registry. The format is YYYY-MM-DD.
- registry_status
: the URI of the status of the prefix as stored in the registry.
- score
: The risk score of the prefix. It ranges from 0 to 99.
- risk
: The risk of the prefix. The allowed values are: LOW, MEDIUM, HIGH. It's a human readable representation of the score.
- prefixes_v6
: the list of IPv6 prefixes that belong to the ASN. Each element of the list is a JSON object with the following structure:
- self
: the URI to individual IPv6 prefix.
- asn
: the URI to query the full details of the ASN.
- object_type
: the type of the prefix. The allowed values are: IPv6.
- maintainer
: the information about the maintainer of this prefix in the registry.
- description
: the description of the prefix as registered in the registry.
- registry_date
: the date of registration of the prefix in the registry. The format is YYYY-MM-DD.
- registry_status
: the URI of the status of the prefix as stored in the registry.
- score
: The risk score of the prefix. It ranges from 0 to 99.
- risk
: The risk of the prefix. The allowed values are: LOW, MEDIUM, HIGH. It's a human readable representation of the score.
Errors
The endpoint will return the following errors:
- a 404 Not Found
error if the AS was not found.
- a 422 Unprocessable Entity
error if the AS number is malformed.
It will also return the API Global errors described in the API description.
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"self":"pariatur ut","prefixes_v4":[{"object_type":"eu v","mantainer":"irure consectetur","description":"eu","self":"ipsum ex","asn":"proident officia ad eiusmod Excepteur","registry_date":"28637622","registry_status":"aliqua eiusmod","score":-42878357,"risk":"UNKNOWN"},{"object_type":"deserunt ut","mantainer":"Ut ullamco","description":"ad culpa reprehenderit eu","self":"magna","asn":"Lo","registry_date":"55301891","registry_status":"quis velit ut cupidatat","score":91542635,"risk":"UNKNOWN"}],"prefixes_v6":[{"object_type":"ullamco et do","mantainer":"in reprehenderit cupidatat officia qui","description":"nisi ipsum ea pariatur nostrud","self":"Lorem eu","asn":"ullamco","registry_date":"07441154","registry_status":"quis ut tempor nostrud","score":-22946602,"risk":"LOW"},{"object_type":"in nisi pariatur ut nulla","mantainer":"officia","description":"elit laboris non","self":"cupidatat ad id","asn":"aliqua","registry_date":"34315202","registry_status":"sint","score":39150301,"risk":"UNKNOWN"}],"asn":"est nostrud laboris dolor"}