Get the Autonomous System details of the AS number given.
GET {{baseUrl}}/v1/asn/:number
What
Obtain the full details 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
- name: the name of the Autonomous System as registered in the registries databases.
- description: the description of the Autonomous System as registered in the registries databases.
- country_code: the ISO 3166-1 alpha-2 country code of the Autonomous System.
- registry_date: the date of registration of the Autonomous System in the registry. The format is YYYY-MM-DD.
- registry: the URI of the registry where the Autonomous System is registered.
- status: the status of the Autonomous System as stored in the registry.
- prefixes: the URI to the list of prefixes that belong to the Autonomous System.
- score: The risk score of the Autonomous System. It ranges from 0 to 99.
- risk: The risk of the Autonomous System. 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
{"name":"dolor","country_code":"PK","registry":"id","status":"nulla eu nisi","prefixes":"est ","self":"do","description":"ut aliquip","registry_date":"29533602","score":-24961739,"risk":"LOW"}