Get the IPv4 or IPv6 prefix of the IP address given.
GET {{baseUrl}}/v1/asn/ip/:ip_address
What
Obtain the IPv4 or IPv6 prefix and the Autonomous System information of the IP address passed as a parameter.
Parameters
The endpoint accepts only the following parameter in the path:
- ip_address
: (Mandatory) The IPv4 or IPv6 address to be queried.
Result
The result 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 or 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 prefix information was not found.
- a 422 Unprocessable Entity
error if the IP address 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
{"object_type":"eiusmod dolore ad non elit","mantainer":"dolore","description":"eiusmod eu sed","self":"adipisicing ex ea","asn":"nisi dolor ut","registry_date":"37670844","registry_status":"laborum Ut elit minim","score":-6518786,"risk":"HIGH"}