Status Codes

Status Code

Message

Meaning

200 (OK)

A JSON object containing the geolocation information

Your request was valid and a response was successfully returned.

400 (Bad Request)

{"message": "127.0.0.1 is a private IP address"}

You tried to look up a private IP address.

400 (Bad Request)

{"message": "bleh does not appear to be an IPv4 or IPv6 address"}

You entered a value that does not appear to be a valid IP address.

400 (Bad Request)

{"message": "Bulk requests should not contain more than 100 IP addresses."}

You tried to lookup more than 100 IP Addresses which is not supported. Reach out to support to increase this limit.

401 (Unauthorized)

​

You did not pass your API key in the request.

403 (Forbidden)

​

You have either exceeded your quota or have entered a non-existent API key.