For technical questions about integrating our products, see the FAQ on our developer website.
- How do I reset my password?
- The person who set up my company's account has left the company. How do I obtain access?
- What types of payments does MaxMind accept?
- Can I receive a discount if I upgrade my GeoIP database to a more detailed version?
- What is MaxMind's refund policy?
GeoIP2 Web Services
- What is GeoIP2 and how does it differ from GeoIP Legacy?
- What is GeoIP2 Precision data?
- Why are my queries being used up at a faster than expected rate?
- Will I get a warning if I am running out of queries?
- Should I choose the GeoIP2 web service or GeoIP Legacy database?
- How accurate are your GeoIP databases?
- How much of the IP Address space do you cover?
- Does MaxMind support IPv6 addresses?
- How many IP addresses are in your database? How many countries are included?
- What is the difference between the GeoIP ISP and Organization databases?
- How many lookups can your GeoIP APIs support per second?
- Which cities are in the GeoIP City database?
GeoIP Database Updates
- What are Cellular and Wi-Fi connections, and how do I identify them?
- How can I find the Postal Code of an IP address?
- I would like to use a GeoIP database on xyz.com, xyz.ca, and xyz.biz. Do I need more than one site license?
- We are a hosting provider and have a license to one of your GeoIP databases. Can we install it on the different servers that we provide to our hosting clients?
- I would like to use the GeoIP data to power a web log/analytics service that I provide to my clients. Is this allowed with just one site license?
- Can I set up a website where my clients can enter an IP address and get GeoIP information back?
- How effective is MaxMind in preventing different types of chargebacks?
- How do I report fraud to MaxMind?
- Can I customize the algorithm used to generate the riskScore returned by the minFraud service?
- How can I make sure the minFraud service is as effective as possible for me?
- Can I use the standard and premium minFraud queries from a single account?
- What is the difference between the standard and premium minFraud services? Which one should I use?
- Can the minFraud service screen orders from every country?
- I run multiple sites. Can I use same minFraud account for the different sites?
- What is a minFraud Alert? What should I do with it?
- Is the minFraud service PCI compliant?
- Do unused queries on a monthly subscription carry over to next month?
- Will you compensate me for any chargebacks?
- Can you identify whether the person placing the order lives at the given address (or uses the given credit card or phone number)?
- Can you tell if a person enters gibberish?
- Does MaxMind provide an address verification service?
You may request a password reset link.
Please email us from a company e-mail address with as much information about the account as you have available, such as the username, contact address, or the first half of the license key.
MaxMind accepts Visa, MasterCard, American Express, and PayPal. We also accept wire transfers and checks drawn on US funds payable to MaxMind, Inc. Please email email@example.com for more details.
Discounts are available for the following upgrades:
- GeoIP Country to GeoIP Region
- GeoIP Country to GeoIP City
- GeoIP Region to GeoIP City
- GeoIP City Subset to GeoIP City
Please see our refund policy.
GeoIP2 Web Services
MaxMind's GeoIP2 web services and GeoIP2 databases are an evolution of our original GeoIP web services and databases, which we now refer to as GeoIP Legacy. See What's New in GeoIP2 for details on enhancements in GeoIP2.
GeoIP2 Precision data is our most accurate data. Our GeoIP2 Precision City and Omni web services accurately geolocate 1% more IPs to cities and 3% more IPs to postal codes than the GeoIP downloadable databases.
Search engine spiders may be crawling your site and depleting your GeoIP web service queries. The robots exclusion standard may help prevent search engines spiders from doing so.
You can write code to check the User-Agent header for the client to see if it's a spider.
If you implemented the robots exclusion standard and still are seeing queries being used up faster than expected, we recommend logging each request to our web service in order to better understand what is causing your code to make a web service request.
We will send a warning email when your remaining queries for a GeoIP web service falls below 10,000.
It depends on your needs. There are four main considerations.
Our GeoIP2 Precision City and Omni web services accurately geolocate 1% more IPs to cities and 3% more IPs to postal codes than the GeoIP downloadable databases.
Our web service has had 99.99% uptime since January 2010 and responds quickly, but with a local copy of the database you are not dependent on the availability of our servers or a specific network route. Also, you can perform many more queries per second with a local database.
You need to download GeoIP Legacy databases yourself in order to have access to the latest and most accurate GeoIP Legacy data. With the GeoIP2 Web Services, you always receive the latest data available.
Once you have purchased a license to a downloadable database, there is no limit on the number of queries you can perform on that database. Based on the number of queries you are doing per month, you may find that either the downloadable databases or the web services are less expensive.
MaxMind tests the accuracy of the GeoIP Databases on a periodic basis. In our recent tests, the GeoIP databases were 99.8% accurate on a country level, 90% accurate on a state level in the US, and 83% accurate for cities in the US within a 40 kilometer radius. For more details, see GeoIP City Coverage and Accuracy.
We cover all of the IPv4 space, including all publicly available IP addresses. Note that some IP addresses may not be in use or may be reserved for private networks. These addresses are not locatable. For example, the IP address 127.0.0.1 is used by each computer to refer to itself, so it cannot be located.
Please see our IPv6 Information and FAQ page.
Please see our page describing IP allocation details.
The ISP database generally contains the ISP name. However, when we are not able to obtain the ISP we include the name of the organization the IP address block was assigned to. For example, the ISP database often contains the names of universities instead of the universities' ISPs.
When only the ISP or organization name is available, both the GeoIP ISP and Organization databases return the same value. In such cases, the shared value usually represents the ISP. When both the ISP and organization names are available, the GeoIP ISP and Organization databases return the ISP and organization, respectively.
Please see our GeoIP benchmarks.
We offer a CSV file that contains all the cities in the GeoIP City database.
GeoIP Database Updates
The GeoIP Country, GeoIP Region and GeoIP City databases are updated every Tuesday. All other databases are updated on the first Tuesday of the month.
We recommend updating at least every 1-3 months, as the data changes frequently.
A cellular IP address is one assigned by a cellular carrier (Verizon, AT&T, T-Mobile, etc.), and the connection is made via the cell tower itself. These are also sometimes referred to as 3G or 4G connections. The GeoIP Netspeed database identifies cellular IP addresses. The GeoIP ISP database identifies who the carrier is.
Wi-Fi is a method of wirelessly connecting to a local area network (LAN), and is independent of any IP address that might be assigned to that LAN--a Wi-Fi connection could be made to a wireless router that is connected to a dial-up, broadband, or commercial modem, or a cellular connection (such as a "portable hotspot"). It is not possible to identify a connection that uses Wi-Fi with only the IP address.
The GeoIP City database includes postal codes for many IP addresses. The percentage of IPs that resolve to a postal code within each of the following countries is approximately:
- Australia, 20%
- France, 23%
- Germany, 14%
- Italy, 18%
- Spain, 11%
- South Africa, 5%
- Switzerland, 28%
- United Kingdom, 9%
- United States, 56%
In many cases we return a city but not a postal code. This is because an ISP may allocate an IP range over multiple postal codes, and we only return a postal code if we are confident in the resolution.
GeoIP2 Precision Web Services Beta accurately geolocate 3% more IPs to postal codes than GeoIP Legacy data.
If accuracy is not a major concern, you may use one of the following solutions. With a postal code database you could lookup a US postal code using the city and state returned by the GeoIP City database. Alternatively you can use the GEO-132 binary Format (without metro and area codes) of GeoIP City, which contains postal codes for every US city-level resolution, even when we aren't confident in the accuracy of the postal code. For the CSV format, we have a location file with postal codes for every US city record.
GeoNames provides free worldwide postal code databases.
I would like to use a GeoIP database on xyz.com, xyz.ca, and xyz.biz. Do I need more than one site license?
As long as you own, operate, and have sole access to those websites, you only need one site license.
We are a hosting provider and have a license to one of your GeoIP databases. Can we install it on the different servers that we provide to our hosting clients?
No. While you can install the databases on multiple servers, they can only be used for internal business purposes. Any company that has access to GeoIP data and databases must have their own license.
I would like to use the GeoIP data to power a web log/analytics service that I provide to my clients. Is this allowed with just one site license?
Only one site license is needed if the GeoIP data resides on your servers and one of the following two conditions is met:
2) GeoIP data is provided in aggregate, where the IP address is not presented with the associated GeoIP data.
You can use a GeoIP Web Service to offer this service.
Using the downloaded GeoIP database to offer this service is not permitted under the license agreement.
MaxMind's minFraud service is effective in detecting stolen card fraud. MaxMind's service does not protect against "friendly" chargebacks where the cardholder placed the order but later denies having placed the order and requests a chargeback.
By reporting fraud to us, you help us to improve our service.
You cannot change how MaxMind calculates the riskScore. However, our minfraud service returns many other data points besides the riskScore. You can implement custom rules based on this data in your own code.
If you report chargebacks to us, we use that information to improve the riskScore.
Changing your blocked country list will affect the riskScores you observe when you see orders from countries you designate as high risk.
First, if you are still using minFraud version 1.0, we recommend upgrading to the latest version of the minFraud service. Upgrading from version 1.0 gives you access to the riskScore, which represents the likelihood that a given transaction is fraudulent.
Second, we recommend you use the
riskScore rather than the
as you make decisions about whether to accept, reject, or review
riskScore is based on sophisticated statistical modelling and real-time data feeds while the
score uses a simple formula. As such, the
riskScore better indicates whether a given order is fraudulent.
Third, the more input fields you pass to the minFraud service, the more accurate the
riskScore will be. In particular, we recommend passing at least the
Fourth, we recommend you use the Device Tracking Add-on for the minFraud service on your site. The add-on helps catch fraudsters who change proxies while they are browsing your website or between visits to your website.
Fifth, you can help us improve the
riskScore by reporting fraud and chargebacks to us.
You can use both standard and premium minFraud queries if you subscribe to both services.
You can use requested_type to specify whether you would like to use the standard or premium minFraud service.
Most clients use the standard service. The premium service provides more information about the credit card's issuing bank and whether the card is a prepaid or gift card. For more details, see our minFraud Feature Comparison page.
Yes. The minFraud service can detect fraud from any country.
Yes, you can use the same minFraud account to screen orders from multiple sites. You can use shopID to specify which website the orders are from.
A minFraud Alert is a notification that a previously scored transaction may be higher risk. These alerts are sent as web requests to a URI that you specify. You can set the URI we make a request to for alerts. You will also receive an email for all alerts.
We have confirmed with Visa that the minFraud service is not required to be PCI compliant, since it doesn't receive the complete 16-digit credit card number. However, we still take data security very seriously.
Yes, unused queries carry over and do not expire.
No. While the minFraud service can be used to identify fraudulent transactions, the decision whether to accept or reject a given transaction is the responsibility of the client.
Can you identify whether the person placing the order lives at the given address (or uses the given credit card or phone number)?
The minFraud service does not collect personally identifiable information such as the cardholder name, street address, or full credit card number. Thus, we cannot perform address verifications.
Not at this time. We hope to have gibberish detection in the future.