Status Codes

A list of status codes and their meanings as returned by the API.

Status Code
Message
200 (OK)
A successful response
400 (Bad Request)
{"message": "127.0.0.1 is a private IP address"}
400 (Bad Request)
{"message": "bleh does not appear to be an IPv4 or IPv6 address"}
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 either exceeded your quota or that API key does not exist. Get a free API Key at https://ipdata.co/registration.html or contact support@ipdata.co to upgrade or register for a paid plan at https://ipdata.co/pricing.html."}​

API Reference - Previous

Response Fields

Next - Use Cases

Blocking Users by Country

Last updated 6 months ago

Status Code	Message
`200 (OK)`	A successful response
`400 (Bad Request)`	{"message": "127.0.0.1 is a private IP address"}
`400 (Bad Request)`	{"message": "bleh does not appear to be an IPv4 or IPv6 address"}
`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 either exceeded your quota or that API key does not exist. Get a free API Key at https://ipdata.co/registration.html or contact support@ipdata.co to upgrade or register for a paid plan at https://ipdata.co/pricing.html."}