Thank you for signing up for a MaxMind service trial account. Your welcome email contains instructions on how to create a password and login to your MaxMind account.


There are four ways to test the GeoIP2 Precision Web Services with varying levels of required integration effort:

MethodIntegration EffortBest for
Online Lookup Form*None
Looking up 1-50 IPs and getting the majority of GeoIP outputs.
Batch Lookup*None
Looking up hundreds to millions of IPs with output in CSV or JSON. Reviewing the full set of service outputs (JSON).
Command Line (curl)Low
Developers testing to integrate directly with our REST API (i.e., not using client APIs).
REST API/ Client APIModerate
Developers testing performance and preparing for live production use.

Online Lookup Form


1. After logging in to your MaxMind account, scroll to the bottom of the left-hand navigation bar and select ‘Online Lookup’ under the ‘GeoIP2’ Section (or click here).

2. Select the service you’d like to query, and then enter up to 50 IP addresses in the space provided with one IP address per line.

* The Online Lookup Form only provides a subset of outputs, intended for quick evaluation.


Batch Lookup


1. Prepare a plain text (ASCII) file containing one unique IP address per line.

2. After logging in to your MaxMind account, scroll to the bottom of the left-hand navigation bar and select ‘Batch Lookup’ under the ‘GeoIP2’ Section (or click here).

3. Select the service you’d like to use, and upload your prepared text file. We will email you once the file has been processed with a link to access both CSV and JSON results for your batch upload.

* The Online Lookup Form and the Batch Lookup CSV file only provide a subset of outputs, intended for quick evaluation. The Batch Lookup JSON file provides the full set of outputs returned by our APIs.


Command Line (curl)


The GeoIP2 Precision Web Services may be accessed using curl, a simple command-line HTTP client. Please see our developer website for further instructions on how to query the services.

You will need to generate a license key [login required] in order to use curl.


REST API / Client Library


The GeoIP2 Precision Web Services integration documentation can be found on our developer website. Officially-supported and third-party client libraries are available for popular programming languages and frameworks. 

You will need to generate a license key [login required] in order to query our API.


If you have any questions or need assistance, please contact us.