Get the different denylists where the IP was found.
GET {{baseUrl}}/v1/denylist/ip/:ip_address
What
Obtain the list of all the different denylists where the IP v4 or v6 entered by the user. The denylisted forbidden datasets are the ones submitted manually by the user from files or indidual items.
Parameters
The endpoint accepts only a IP v4 or v6 address as the following parameter in the query string.
Result
The result is a JSON object with a list of the following JSON objects:
- self
: the URI to individual status.
- cidrs
: a list of JSON objects where the IP address was found with the following fields:
- self
: the URI to individual CIDR information.
- last_report
: Unix timestamp in milliseconds when the IP address or CIDR was last submitted.
- description
: A string with the description of the IP address or CIDR.
- expiry
: Unix timestamp in milliseconds when the IP address or CIDR will expire and be removed.
- protocol
: IP protocol version of the IP address. Same value as the ip_protocol_version
parameter if given.
- country
: the URI to the country where the IP address was found. If not found, the result is an empty string.
- continent
: the URI to the continent where the IP address was found. If not found, the result is an empty string.
- asn
: the URI to the ASN where the IP address was found. If not found, the result is an empty string.
- datacenter
: the URI to the datacenter where the IP address was found. If not found, the result is an empty string.
- reported
: a list of JSON objects of the reported IP addresses with the following fields:
- self
: the URI to individual reported IP information.
- last_report
: Unix timestamp in milliseconds when the IP address was last reported.
- expiry
: Unix timestamp in milliseconds when the IP address will expire and be removed.
- total_reports
: Total number of reports for the IP address.
- protocol
: IP protocol version of the IP address. Values can be IPV4 or IPV6.
- dataset
: Name of the dataset where the IP address was reported. Must be a value from the /v1/dataset/ip
endpoint.
- tags
: A list of strings with the tags associated to the IP address at the origin device. It helps to classify the origin of the report.
Errors
- a
400 Bad Request
error if the IP address is not public. - a
422 Unprocessable Entity
error if the IP address was 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":"aliquip","cidrs":[{"self":"sint ex nisi nulla","last_report":-50127991,"description":"et consequat dol","expiry":78460801,"protocol":"IPV4"},{"self":"sed consectetur exercitation Ut","last_report":3304763,"description":"eu irure","expiry":-58188735,"protocol":"ALL"}],"country":"","continent":"","asn":"","datacenter":""}