License keys are unique identifiers, used by customers to authenticate database download and web service requests. You will need a license key if you want to programmatically download a database, or query a web service. A license key is tied to your account, and anyone with your license key could use it to download databases or query web services via your account. This could use up your database download limit or service credit. You are responsible for what people do with your license keys, so they should be treated essentially as a password.

Please note that when you generate a license key it will only be displayed to you once. You must record your license key securely when it is first generated. If you forget to record it or lose it, you may simply generate a new license key and remove the one you have lost.

Generating a License Key
Recording and Storing Your License Key
Using Your License Keys
Managing Your License Keys

Generating a License Key

You must have a MaxMind account in order to generate a license key. You must sign up for one of MaxMind’s products or services in order to create an account.

Once you have a MaxMind account, you may generate a license key. First log in and navigate to ‘Manage License Keys’ underneath ‘Account’ on the left-hand navigation menu.

You may also access the page directly here [login required].

Next, click on the ‘Generate new license key’ button.

You can generate a new MaxMind license key by clicking the blue "Generate new license key" button.

You will now be prompted to provide some information about the license key you would like to generate.

Give your MaxMind License Key a description and specify its intended use.

License key description

The license key description is for your reference only. The license key description will label the license key in your account portal. It may be useful to label your license keys if you intend to use different keys for different applications or servers. You can then use these labels to filter usage reports [login required], to help you track usage across different applications or servers.

Please note that you can have a maximum of 25 license keys active at any given time, so plan your license key usage with this in mind. If you have more than 25 different servers or applications you would like to track, you will have to group them.

For Use in GeoIP Update

Next you will be asked whether this license key will be used for the GeoIP Update program. The GeoIP Update program is used to automate updates to binary GeoIP downloadable databases. If you are generating a license key for use with GeoIP Update, select “Yes” and specify the version of GeoIP Update you are using.

If you are using the license key for any other purpose, select “No.”

Recording and Storing Your License Key

After you click confirm, your license key will be displayed. This is the only time that you will be able to view the full license key, so you must copy the license key before proceeding.

Your full MaxMind License Key will only be displayed to you once. Make sure to record it securely.

Remember that the license key provides the holder with access to your MaxMind databases and/or service credit, so it should be treated with the same security as a password (learn more about keeping your license keys secure).

Using Your License Keys

The license key is typically paired with the Account ID number for authentication of API requests. For users of GeoIP2 or GeoLite2 downloadable databases, this will most likely be with our GeoIP Update program. For users of our minFraud, GeoIP2, or GeoLite2 web services, this will most likely be in web service requests.

You can see an example of how the license key is used in web service queries in this brief tutorial on integrating GeoIP2 and GeoLite2 web services with PHP from our blog.

Viewing Your License Key Usage

You can see how your license keys have been used by generating a Query Usage Report in your account portal. Log in to your account and navigate to ‘Query Usage Report’ underneath ‘Billing’ on the left-hand navigation menu.

You can query your usage by navigating to the "query usage report" action under the "Billing" menu.

You may also access the page directly here [login required].

To generate a report of your query usage, specify a date range. You can filter your report based on the service, and based on the license key. If you are trying to track down unusually high query usage, you can filter based on your license keys to help identify whether a particular application or server is querying your services more than expected.

You can filter your usage reports by your MaxMind License Key.

Managing Your License Keys

You can see a list of all your license keys in your account portal. For the security of your account, only the license key descriptions chosen when you created the keys, and the first four digits of your license keys, are displayed in your account portal. This prevents someone from using your license keys if they gain unauthorized access to your account.

To access your list of license keys, log in to your account and navigate to ‘Manage License Keys’ underneath ‘Account’ on the left-hand navigation menu.

You may also access the page directly here [login required].

Your MaxMind License Keys will be listed, displaying the description you specified at creation as well as the first four digits of the key.

You can edit your license key description by clicking on the pencil icon. The license key description is only for your records, and editing its description will not impact how the license key is used in your integration.

Removing License Keys

Because the license key provides access to your MaxMind products and services, you should remove any license keys that are not being used. You should also remove a license key if you think it has been compromised (learn more about keeping your license keys secure).

Please note that when you remove a license key, it will no longer be usable. Queries sent with a license key that has been removed will return an error.

If you need to remove a license key that is currently used in your integration, you should first generate a new license key and replace the old license key in your integration. Once the old license key has been removed from your integration, you may proceed to remove the old license key from your account.

To remove a license key, click on the trash icon in the rightmost column of the license key you wish to remove. You will be asked to confirm that you would like to remove the license key.

Please note that you cannot remove your last license key. If you no longer need a license key and would like to remove all active license keys, you can simply generate a new license key without recording it, and leave this new key unused in your account. You may then remove the old license key.


Didn’t find what you were looking for? Consult our License Key FAQs.