GeoIP and GeoLite API Requests
The endpoint for each service is as specified below. Each endpoint expects an IP
adddress to be defined as a path parameter (
The IP address can be either an IPv4 or an IPv6 address. IPv4 addresses should
be passed in the standard dotted quad form, for example
addresses should be passed as strings as well. We recommend using the canonical
form as described in RFC 5952, for
2001:db8::1:0:0:1, but we will handle any valid IPv6 string
You can also use the string
me as the IP address. In this case, the record for
the IP address you are querying from will be returned. This is useful when your
application does not have easy access to its public IP address, e.g., when the
system making the query is behind a NAT.
geoip.maxmind.com hostname automatically picks the data center
geographically closest to you.
geolite.info hostname automatically picks the data center geographically
closest to you.
Authorization header is always required. See
Authorization and Security for more details.
Accept header for a request is entirely optional. If you do include one,
you must accept one of the following:
application/vnd.maxmind.com-country+json; charset=UTF-8; version=2.1
Substitute the appropriate service's type for "country". A request for any other
MIME type will result in a
415 Unsupported Media Type error.
If you set the
Accept-Charset header in your client code, you must accept the
UTF-8 character set. If you don't you will receive a
406 Not Acceptable
Troubleshooting IP Lookups
Learn about common troubleshooting steps to make sure that you're querying the correct IP addresses, and making efficient use of your queries, on our Knowledge Base.
This page was last updated on June 6, 2023.