API Status Codes
A list of status codes and their meanings as returned by the API.
| Status Code | Message | Meaning |
|---|---|---|
| 200 (OK) | A JSON response containing the requested information. | A successful response |
| 400 (Bad Request) | {"message": "127.0.0.1 is a private IP address"} | |
| 400 (Bad Request) | {"message": "224.244.244.244 is a reserved IP address."} | |
| 400 (Bad Request) | {"message": "bleh does not appear to be an IPv4 or IPv6 address"} | |
| 400 (Bad Request) | {"message": "You did not provide a valid JSON Array."} | You need to provide a valid JSON array in the POST body of bulk requests |
| 400 (Bad Request) | {"message": "Bulk requests should not contain more than 100 IP addresses."} | |
| 401 (Unauthorized) | {"message": "You have not provided a valid API Key."} | |
| 403 (Forbidden) | {"message": "You have exceeded your free quota. Upgrade to a paid plan to re-activate your account."} | |
| 403 (Forbidden) | {"message": "You have made 20,000 requests and have exceeded your daily quota. Upgrade to the next plan to re-activate your account."} | |
| 403 (Forbidden) | {"message": "Upgrade to a paid plan to make bulk requests."} | |
| 403 (Forbidden) | {"message": "Upgrade to a paid plan to access ASN data."} | |
| 403 (Forbidden) | {"message": "IP or domain not in whitelist."} | |
| 404 (Not Found) | {"message": "ASBlah was not found."} | You requested an ASN that does not exist. |
Updated over 2 years ago