GeoIP2 Release Notes

Changes to Registered Country data

We have made some changes to how we determine the registered country associated with an IP address. We estimate that this change will affect around 1% of IP addresses with a registered country value. The following databases and web services will be affected:

• GeoIP2 Country database
• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoLite2 Country database
• GeoLite2 City database
• GeoIP2 Country web service
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• GeoLite2 Country web service
• GeoLite2 City web service
• minFraud Insights web service
• minFraud Factors web service

In some cases where we are no longer confident in the registered country for an IP, it will be removed. In other cases, the value may be changed.

You can learn more about the /registered_country output in the API schema for GeoIP2 web services.

You can learn more about the difference between registered country and the IP geolocation on our Knowledge Base.

Change to Time Zone Name for Ukraine

The time zone name for Kyiv, Ukraine, which covers most of the country, has been updated.

Previously, the time zone was named Europe/Kiev. It has been updated to be named Europe/Kyiv following updated naming conventions from version 2022b of the IANA time zone database.

The following products and services will see the updated time zone name:

• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• minFraud Insights
• minFraud Factors
• GeoLite2 City database
• GeoLite2 City web service

GeoNames Monthly Diff Report September 2022

GeoNames Monthly Diff Report (September 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of September as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

Geolocation Bug Fix Complete

We have completed work to fix a geolocation bug affecting some IPv6 addresses. All databases and web services should now have the updated data.

See the release note below for more information about this bug.

Updated GeoIP2 Enterprise Database Available

We have released an updated version of the GeoIP2 Enterprise database, which fixes a geolocation bug affecting some IPv6 addresses.

See the release note below for more information about this bug.

Customers should download the updated GeoIP2 Enterprise database at their earliest convenience.

Updated GeoIP2 City Database Available

We have released an updated version of the GeoIP2 City database, which fixes a geolocation bug affecting some IPv6 addresses.

See the release note below for more information about this bug.

Customers should download the updated GeoIP2 City database at their earliest convenience.

Geolocation Coordinate Bug Fix

We are aware of a bug in which databases and web services have been returning geolocation location coordinates of 0,0 for IPv6 addresses which are geolocated only down to the country-level.

The following databases and web services are affected:

• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoIP Legacy City web service
• GeoIP Legacy Omni/Insights web service
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• minFraud Insights web service
• minFraud Factors web service

We have a fix, and it will be released later today.

The updated GeoIP2 City database is now available for download.

Web service users will see the corrected data as soon as the fix has been implemented.

We apologize for any inconvenience this may have caused.

GeoNames Monthly Diff Report August 2022

GeoNames Monthly Diff Report (August 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of August as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

* This month's update corrects an error in which several subdivisions in China had their names populated into the city_name field by error. The city_name field for these subdivisions has been removed.

GeoNames Monthly Diff Report July 2022

GeoNames Monthly Diff Report (July 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of July as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report June 2022

GeoNames Monthly Diff Report (June 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of June as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoIP Legacy databases have been retired

In line with the announcement on our blog from 2020, GeoIP Legacy databases have been retired.

Data changes to GeoIP Legacy web services

In line with the announcement on our blog from 2020, there will be several changes to the data in our GeoIP Legacy web services beginning today. The following web services are affected:

• GeoIP Legacy City
• GeoIP Legacy City/ISP/Org
• GeoIP Legacy Insights (formerly known as Omni)

The following data changes have been made:

1. Region codes: The legacy web services historically returned region codes in the FIPS 10-4 standard (for all countries except for the US and Canada). Now, region codes worldwide will be returned in the ISO 3166-2 standard.
2. Area codes: Area code fields will now return blank.
3. Country/Region/City names: Country, region, and city names will now come from GeoNames.

For more information, read the full announcement on our blog from 2020.

Please note that associated changes to the minFraud Legacy web services are also being made.

GeoLite databases will now receive twice weekly updates

Starting this Friday, May 27, GeoLite databases will be updated twice weekly, on Tuesdays and Fridays. The following databses are affected:

• GeoLite2 Country Database
• GeoLite2 City Database
• GeoLite2 ASN Database

The twice weekly database updates will allow us to more quickly incorporate data corrections.

Please update your integration to download updates according to this new schedule.

For more information about database updates see the documentation our Developer Portal and Knowledge Base.

GeoNames Monthly Diff Report May 2022

GeoNames Monthly Diff Report (May 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of May as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report April 2022

GeoNames Monthly Diff Report (April 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of April as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report March 2022

GeoNames Monthly Diff Report (March 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of March as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

Update Regarding IP Geolocations in Ukraine

IP addresses that are geolocated to the regions of Donetsk and Luhansk currently return Ukraine for the country in MaxMind's products and services.

MaxMind's IP geolocation products and services use GeoNames to determine the name of the country in which an IP address is located. At this time, we do not have plans to diverge from GeoNames for IP addresses located in disputed regions.

February Holiday Database Release Schedule

Due to the holidays on Monday, February 21, database updates scheduled for Tuesday, February 22 will be delayed by about one day.

The following database updates will be delayed:

• GeoIP2 Country
• GeoIP2 City
• GeoIP2 Connection Type
• GeoIP2 ISP
• GeoIP2 Enterprise
• GeoLite2 Country
• GeoLite2 City
• GeoLite2 ASN

The GeoIP Legacy database updates will also be delayed.

The GeoIP2 Anonymous IP database will continue to update as scheduled.

We will resume our regular update schedule beginning on Friday, February 25.

GeoNames Monthly Diff Report February 2022

GeoNames Monthly Diff Report (February 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of February as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

* This month's update has a large number of changes to the GeoNames ID for locations in China due to some changes in how we process GeoNames data for China.

Dialup values for connection_type and user_type deprecated

We have deprecated the dialup values for connection_type and user_type in our GeoIP2 products and services:

• GeoIP2 Connection Type database
  • connection_type no longer has the possible value of Dialup
• GeoIP2 Enterprise database
  • connection_type no longer has the possible value of Dialup
  • user_type no longer has the possible value of dialup
• GeoIP2 Insights web service
  • user_type no longer has the possible value of dialup

You can see a list of possible values for the connection_type data point in our documentation for the GeoIP2 Connection Type database.

You can see a list of possible values for the user_type data point in the API schema for our GeoIP2 web services.

Mobile country and mobile network code data

We have added data containing the mobile country code and mobile network code to several of our GeoIP2 product and services. Mobile country code and mobile network code data uniquely identify mobile network operators (carriers). This data can be used for carrier segmentation and targeting as well as general analytics. Learn more about mobile country code data on Wikipedia.

This data will be included in the following GeoIP2 products and services:

• GeoIP2 ISP database
• GeoIP2 Enterprise database
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• minFraud Insights web service
• minFraud Factors web service

GeoNames Monthly Diff Report January 2022

GeoNames Monthly Diff Report (January 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of January as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoIP2 Precision is now GeoIP2 web service

We're dropping the "Precision" from our GeoIP2 web service names to make the closest equivalent between our web services and databases clearer, and to make it clear that IP geolocation is not precise enough to locate individuals or street addresses. You can learn more about the accuracy and limitations to IP geolocation on our knowledge base.

We are also renaming our city-level geolocation web service to be GeoIP2 City Plus. We have added "Plus" to this web service to make it clearer that the city-level geolocation web service also contains IP network data. You can see a list of all data points in the GeoIP2 City Plus web service on our main website.

Nothing has changed about how to use our web services, and no changes are required to your current integration.

Our GeoIP2 web services will be renamed as follows: