IP Location Database (Advance)

Overview

Our Geo Advance IP to Geolocation Database provides you with precise city level geolocation data for both IPv4 and IPv6 addresses. Compared to our Geo Standard IP to Geolocation Database, it adds extra fields such as accuracy radius, confidence score, and DMA codes (DMA codes are available in the USA only) to give you the pinpoint accuracy you need to make tighter decisions.

Every IP range is linked to countries, states, districts, and cities, with multilingual place names resolved through reference tables for consistency. This structure makes it easy to join datasets and work with standardized metadata across different regions and languages. Our collection pipelines run nonstop, around the clock, with database updates delivered on a daily or weekly cadence depending on your subscription plan. The dataset is available in CSV and MMDB, with JSON, Parquet, or any custom format on request at no extra cost, all backed by stable schemas and changelogs.

Below, you'll find full documentation of the archive contents, schema definitions, file specifications, and integration notes to help you get up and running quickly.

Available Database Formats

CSV
CSVCSV
  • File Size: 662.87 MB
  • Entries: 49.2M
  • Fields: 16
  • Last Updated: Yesterday
Documentation
MMDB
MMDBMMDB
  • File Size: 968.16 MB
  • Entries: 49.2M
  • Fields: 16
  • Last Updated: Yesterday
Documentation

CSV Database Documentation

1. Overview

The CSV version of our Advance IP to Location Database is delivered as a ZIP archive that includes Gzip-compressed files with IP ranges, location details, and multilingual place names. It's well-suited for bulk imports and easy integration into relational databases.

2. Archive Content

After downloading and extracting the Advance IP to Location CSV database archive, you'll find the following files (with their types noted):

db-country.csv.gz
db-country.csv.gzdb-country.csv.gz

Standardized country and continent metadata with codes, currency, calling codes, TLDs, and languages.

  • File Size: 9.67 KB
  • Entries: 254
  • Fields: 15
db-place.csv.gz
db-place.csv.gzdb-place.csv.gz

Multilingual place names for cities, districts, states, countries, and continents.

  • File Size: 13.06 MB
  • Entries: 340.2K
  • Fields: 13
db-ip-location.csv.gz
db-ip-location.csv.gzdb-ip-location.csv.gz

IP ranges mapped to locations with place IDs (for multilingual responses), ZIP codes, coordinates, time zone, and connection type.

  • File Size: 652.48 MB
  • Entries: 49.2M
  • Fields: 16
README.md
README.mdREADME.md

Documentation for dataset contents, schema, usage, and support.

  • File Size: 9.79 KB
checksum.txt
checksum.txtchecksum.txt

SHA-256 checksums for verifying file integrity.

  • File Size: 330 Bytes

Schema

This section describes the schema of each file included in the Advance IP to Location Database archive. For every file, you'll find its purpose, field definitions, and examples to help with integration.

1. db-ip-location.csv.gz

This file provides geolocation data for IPv4 and IPv6 ranges, mapped down to the city level. Each record links an IP block to country, state, district, and city (through place IDs for multilingual response), geographic coordinates, time zone, GeoNames ID, and connection type. It also includes accuracy radius, confidence level, and DMA codes (U.S. only) for finer and more granular details.

FieldTypeDescriptionCan be empty?Example
start_ipstringThe starting IP address of the range in IPv4 or IPv6 format.No192.168.0.1
end_ipstringThe ending IP address of the range in IPv4 or IPv6 format.No192.168.0.255
country_idnumberThe unique identifier for the country associated with the IP range.No192
state_place_idnumberThe unique identifier for the state or province associated with the IP range.Yes5332921
state_codestringThe two-letter code representing the state or province with country-code, following ISO 3166-2 standards.YesCA
district_place_idnumberThe unique identifier for the district associated with the IP range.Yes5332923
city_place_idnumberThe unique identifier for the city associated with the IP range.Yes5375480
accuracy_radiusnumberThe accuracy radius in kilometers for the location associated with the IP range.No20
confidencenumberThe confidence level (0-100) of the location data associated with the IP range.No95
dma_codenumberThe Designated Market Area (DMA) code for the location associated with the IP range.Yes807
zip_codestringThe postal code for the location associated with the IP range.Yes94043
latitudenumberThe latitude coordinate of the location associated with the IP range.No37.3861
longitudenumberThe longitude coordinate of the location associated with the IP range.No-122.0838
geo_name_idnumberThe GeoNames ID for the location associated with the IP range.Yes5375480
time_zone_namestringThe time zone name for the location associated with the IP range.NoAmerica/Los_Angeles
connection_typestringThe type of internet connection associated with the IP range (e.g., dialup, cable, DSL, fiber, etc.).Yescable

1. Example Records

Example
start_ip,end_ip,country_id,state_place_id,state_code,district_place_id,city_place_id,accuracy_radius,confidence,dma_code,zip_code,latitude,longitude,geo_name_id,time_zone_name,connection_type
174.52.173.188,174.52.173.188,172,586,US-UT,4475,37711,8.086,high,770,84094,40.563718,-111.860892,5784731,America/Denver,Cable
79.56.50.110,79.56.50.110,80,359,IT-25,4181,25587,3.023,high,,25069,45.633957,10.195015,3164308,Europe/Rome,DSL
113.211.50.16,113.211.50.16,118,279,MY-10,8674,38885,9.852,high,,40604,3.075836,101.517143,10072618,Asia/Kuala_Lumpur,Mobile
218.172.36.190,218.172.36.190,202,1122,TW-TPE,300,1122,9.639,high,,104,25.050522,121.521562,10125105,Asia/Taipei,Fixed Broadband
175.100.188.38,175.100.188.38,76,291,IN-MH,3720,3729,12.128,medium,,400065,19.14045,72.88234,10290240,Asia/Kolkata,Fixed Broadband
76.139.195.112,76.139.195.112,172,591,US-MI,4539,4348,6.206,high,505,48317,42.66957,-83.03386,7145595,America/Detroit,Cable
212.227.17.96,212.227.17.101,41,356,DE-HE,57697,57697,7.488,high,,60311,50.11208,8.68341,6463469,Europe/Berlin,Satellite
2601:249:8a01:83e0:dc7:c6d5:25f6:d8f1,2601:249:8a01:83e0:dc7:c6d5:25f6:d8f1,172,402,US-IL,240078,240079,9.737,high,602,60470,41.04878,-88.62806,4912887,America/Chicago,Cable
148.227.69.0,148.227.69.0,8,399,AR-B,8804,399,7.937,high,,C1043,-34.60368,-58.38156,6285783,America/Argentina/Buenos_Aires,Satellite
61.155.154.236,61.155.156.255,35,277,CN-JS,23832,23832,8.813,medium,,215007,31.29938,120.61958,10284408,Asia/Shanghai,Fixed Broadband

2. db-place.csv.gz

This file contains multilingual names for countries, continents, states, districts, and cities worldwide. It serves as the reference dictionary for the IP Location Database, allowing you to resolve place IDs into multilingual responses across different regions and languages.

FieldTypeDescriptionCan be empty?Example
idnumberThe unique identifier for the place.No5375480
place_englishstringThe name of the place in English.NoMountain View
place_germanstringThe name of the place in German.YesMountain View
place_russianstringThe name of the place in Russian.YesМаунтин-Вью
place_koreanstringThe name of the place in Korean.Yes마운틴 뷰
place_portuguesestringThe name of the place in Portuguese.YesMountain View
place_japanesestringThe name of the place in Japanese.Yesマウンテンビュー
place_persianstringThe name of the place in Farsi.Yesماونتین ویو
place_frenchstringThe name of the place in French.YesMountain View
place_chinesestringThe name of the place in Chinese.Yes山景城
place_spanishstringThe name of the place in Spanish.YesMountain View
place_czechstringThe name of the place in Czech.YesMountain View
place_italianstringThe name of the place in Italian.YesMountain View

2. Example Records

Example
id,place_english,place_german,place_russian,place_korean,place_portuguese,place_japanese,place_persian,place_french,place_chinese,place_spanish,place_czech,place_italian
4348,Shelby,Shelby,Шелби,,Condado de Shelby,シェルビー,شهرستان شلبی، تنسی,Comté de Shelby,谢尔比,Shelby,Shelby,Shelby
300,Taipei City,Taipeh Stadtzentrum,Тайбэй,,,台北市長,,Ville de Taipei,台北市,Tchaj-pej,Tchaj-pej,Taipei City
5,Asia,Asien,Азия,Ásia,Ásia,アジア, آسیا,Asie,亚洲,Asia,Asie,Asia
6,North America,Nordamerika,Северная Америка,América do Norte,América Do Norte,北アメリカ, امریکای شمالی,Amérique du Nord,北美洲,Norteamérica,Severní Amerika,America del Nord
7,Europe,Europa,Европа,Europa,Europa,ヨーロッパ, اروپا,Europe,欧洲,Europa,Evropa,Europa
8,South America,Südamerika,Южная Америка,América do Sul,América Do Sul,南アメリカ,امریکای جنوبی,Amérique du Sud,南美洲,Sudamérica,Jižní Amerika,America del Sud
239882,Republic of Argentina,,,,,,,,,,,
3723,New Delhi,Neu-Delhi,Нью-Дели,Nova Deli,,ニューデリー,,New Delhi,新德里,Nueva Delhi,New Delhi,Nuova Delhi
291,Maharashtra,Maharashtra,Махараштра,Maarastra,Maarastra,マハーラーシュトラ州,مهاراشترا,Maharashtra,马哈拉施特拉邦,Maharastra,Maháráštra,Maharashtra
591,Michigan,Michigan,Мичиган,Michigão,Michigão,ミシガン州,میشیگان,Michigan,密歇根州,Michigan,Michigan,Michigan
25587,Villa Carcina,Villa Carcina,Вилла Карчина,,,ヴィラカルチーナ,,Villa Carcina,卡爾西納,Villa Carcina,Villa Carcina,Villa Carcina
402,Illinois,Illinois,Иллинойс,Ilinóis,Ilinóis,イリノイ州,ایلینوی,Illinois,伊利诺伊州,Illinois,Illinois,Illinois
12,China,China,Китай,China,China,中国,چین,Chine,中国,China,Čína,Cina
356,Hesse,Hessen,Гессен,헤센 주,,ヘッセン,,Hesse,黑森,Hessen,Hesensko,Assia
15,India,Indien,Индия,Índia,Índia,インド,هند,Inde,印度,India,Indie,India
275,Beijing,Peking,Пекин,,,北京,,Municipalité de Pékin,北京,Peking,Peking,Pechino
16,Malaysia,Malaysia,Малайзия,Malásia,Malásia,マレーシア,مالزی,Malaisie,马来西亚,Malasia,Malajsie,Malesia
399,Buenos Aires,Buenos Aires,Буэнос-Айрес,,,ブエノスアイレス,,Buenos Aires,布宜诺斯艾利斯,Buenos Aires,Buenos Aires,Buenos Aires
278,Kuala Lumpur,Kuala Lumpur,Куала-Лумпур,Kuala Lumpur,,クアラ・ルンプール,,Kuala Lumpur,吉隆坡国际机场,Kuala Lumpur,Kuala Lumpur,Kuala Lumpur
240018,United States of America,,,,,,,,,,,
240019,"Washington, D.C.",,,,,,,,,,,
399,Buenos Aires,Buenos Aires,Буэнос-Айрес,,,ブエノスアイレス,,Buenos Aires,布宜诺斯艾利斯,Buenos Aires,Buenos Aires,Buenos Aires
240078,Sunbury Township,,,,,,,,,,,
28,United States,USA,США,Estados Unidos,Estados Unidos,アメリカ合衆国,ایالات متحدهٔ امریکا,États-Unis,美国,Estados Unidos,Spojené státy americké,Stati Uniti d'America
239901,People’s Republic of China,,,,,,,,,,,
27,Taiwan,Taiwan,Тайвань,Taiwan,Taiwan,中華民国,تایوان,Taïwan,台湾,Taiwán,Taiwan,Taiwan
33,Germany,Deutschland,Германия,Alemanha,Alemanha,ドイツ連邦共和国,آلمان,Allemagne,德国,Alemania,Německo,Germania
239906,Federal Republic of Germany,,,,,,,,,,,
38885,Shah Alam,Schah Alam,Шах-Алам,샤알람,,シャー・アラム,شاه عالم,Shah Alam,莎阿南,Šáh Alam,Šáh Alam,Scià Alam
35,Italy,Italien,Италия,Itália,Itália,イタリア共和国,ایتالیا,Italie,意大利,Italia,Itálie,Italia
279,Selangor,Selangor,Селангор,슬랑오르 주,,セランゴール州,سلانگور,Selangor,雪蘭莪,Selangor,Selangor,Selangor
240044,Republic of China,,,,,,,,,,,
562,Berlin,Berlin,Берлин,베를린,Berlim,ベルリン,برلین,Berlin,柏林,Berlín,Berlín,Berlino
54,Argentina,Argentinien,Аргентина,Argentina,Argentina,アルゼンチン共和国,آرژانتین,Argentine,阿根廷,Argentina,Argentina,Argentina
240079,Budd,,,,,,,,,,,
239935,Republic of India,,,,,,,,,,,
1122,Taipei,Taipeh,Тайбэй,Taipé,Taipé,台北市,تایپه,Taipei,台北市,Taipéi,Taipei,Taipei
3729,Mumbai,Mumbai,Мумбаи,Mumbai,,ムンバイ,,Bombay,孟买,Bombay,Bombaj,Mumbai
239939,Republic of Italy,,,,,,,,,,,
37711,White City,Weiße Stadt,Уайт-Сити,,,ホワイトシティ,,Ville Blanche,白城,Bílé město,Bílé město,Città Bianca
4539,Macomb County,Macomb,Маком,,Condado de Macomb,マコーム郡,شهرستان مکمب، میشیگان,Comté de Macomb,马科姆县,Маком,Macomb County,Contea di Macomb
8674,Petaling,Petaling,Петалинг,,,プタリン,,Pétales,八打林,Petaling,Petaling,Petalo
586,Utah,Utah,Юта,Utá,Utá,ユタ州,یوتا,Utah,犹他州,Utah,Utahu,Utah
1122,Taipei,Taipeh,Тайбэй,Taipé,Taipé,台北市,تایپه,Taipei,台北市,Taipéi,Taipei,Taipei
277,Jiangsu,Jiangsu,Цзянсу,,,江蘇省,,Province de Jiangsu,江苏省,Jiangsu,Jiangsu,Jiangsu
3720,Mumbai Suburban,Mumbai,Мумбаи,,,ムンバイ郊外,,Mumbai Suburban,孟买郊区,Bombaj,Bombaj,Suburban di Mumbai
57697,Frankfurt,Frankfurt (Oder),Франкфурт-на-Одере,,Frankfurt an der Oder,フランクフルト,,Francfort-sur-l'Oder,法兰克福,Frankfurtu,Frankfurtu,Francoforte
8804,Comuna 1,Comuna 1,Комуна 1,,,コムナ,,Comuna 1,科莫纳一号,Comuna 1,Comuna 1,Comuna 1
4475,Salt Lake County,Salt Lake,Солт-Лейк,,Condado de Salt Lake,ソルトレイク郡,شهرستان سالت‌لیک، یوتا,Comté de Salt Lake,鹽湖縣,Comté de Salt Lake,Slané jezero,Contea di Salt Lake
3952,Rome,Rom,Рим,,,ローマ,,Rome,罗马,Roma,Řím,Roma
23832,Suzhou,Suzhou,Сучжоу,Suzhou,Suzhou,蘇州市,سوژو,Suzhou,苏州,Suzhou,Su-čou,Suzhou
359,Lombardy,Lombardei,Ломбардия,롬바르디아 주,,ロンバルディア州,,Lombardie,伦巴第大区,Lombardía,Lombardie,Lombardia
4181,Brescia,Brescia,Брешиа,Bréscia,,ブレシア,,Brescia,布雷西亚,Brescia,Brescia,Brescia

3. db-country.csv.gz

This file contains standardized country metadata for the IP Location Database. It includes continent codes and names, ISO-2/ISO-3/IOC country codes, country and official names (as place IDs), capital (place ID), currency (code, name, symbol), international calling codes, top-level domains (TLDs), and supported language tags.

FieldTypeDescriptionCan be empty?Example
idnumberThe unique identifier for the country.No192
continent_codestringThe continent code associated with the country.NoNA
continent_name_place_idnumberThe unique identifier for the continent place.No6255148
country_code2stringThe ISO 3166-1 alpha-2 code of the country.NoUS
country_code3stringThe ISO 3166-1 alpha-3 code of the country.NoUSA
country_code_iocstringThe IOC country code.NoUSA
country_name_place_idnumberThe unique identifier for the country place.No6252001
country_name_official_place_idnumberThe unique identifier for the official country place.No6252001
country_capital_place_idnumberThe unique identifier for the capital place.No5375480
currency_codestringThe ISO 4217 currency code of the country.NoUSD
currency_namestringThe name of the currency used in the country.NoUnited States Dollar
currency_symbolstringThe symbol of the currency used in the country.No$
calling_codestringThe international calling code of the country.No+1
tldstringThe top-level domain (TLD) of the country.No.us
languagesstringThe official languages spoken in the country, represented as a comma-separated list of ISO 639-1 codes.Noen,es

3. Example Records

Example
id,continent_code,continent_name_place_id,country_code2,country_code3,country_code_ioc,country_name_place_id,country_name_official_place_id,country_capital_place_id,currency_code,currency_name,currency_symbol,calling_code,tld,languages
35,AS,5,CN,CHN,CHN,12,239901,275,CNY,Yuan Renminbi,¥,+86,.cn,"zh-CN,yue,wuu,dta,ug,za"
76,AS,5,IN,IND,IND,15,239935,3723,INR,Indian Rupee,₹,+91,.in,"en-IN,hi,bn,te,mr,ta,ur,gu,kn,ml,or,pa,as,bh,sat,ks,ne,sd,kok,doi,mni,sit,sa,fr,lus,inc"
118,AS,5,MY,MYS,MAS,16,16,278,MYR,Malaysian Ringgit,RM,+60,.my,"ms-MY,en,zh,ta,te,ml,pa,th"
8,SA,8,AR,ARG,ARG,54,239882,399,ARS,Argentine Peso,$,+54,.ar,"es-AR,en,it,de,fr,gn"
172,NA,6,US,USA,USA,28,240018,240019,USD,US Dollar,$,+1,.us,"en-US,es-US,haw,fr"
41,EU,7,DE,DEU,GER,33,239906,562,EUR,Euro,€,+49,.de,de
80,EU,7,IT,ITA,ITA,35,239939,3952,EUR,Euro,€,+39,.it,"it-IT,de-IT,fr-IT,sc,ca,co,sl"
202,AS,5,TW,TWN,TPE,27,240044,1122,TWD,New Taiwan Dollar,NT$,+886,.tw,"zh-TW,zh,nan,hak"

4. File Relationship Diagram

Image

File Format & Encoding

All Advance IP to Location CSV datasets are provided in UTF-8 encoding, comma-separated, and compressed with Gzip (.csv.gz). Each file includes a header row listing the field names for clarity and consistency.

Field values are unquoted by default, with quotes applied only in the following cases:

  • Line breaks within text fields.
  • Commas inside a value (e.g., addresses).
  • Lists of values (e.g., languages).
  • Spaces that may be auto-quoted by export tools.

MMDB Database Documentation

1. Overview

The MMDB version of our Advance IP to Location is delivered as a ZIP archive that includes a single MMDB file with all geolocation data (including multilingual place fields), a README file, and a checksum file. It's optimized for fast lookups in applications and services, making it ideal for real-time queries and direct integration into your systems.

2. Archive Content

After downloading and extracting the Advance IP to Location MMDB database archive, you'll find the following files (with their types noted):

db-ip-location.mmdb
db-ip-location.mmdbdb-ip-location.mmdb
  • File Size: 3.58 GB
  • Entries: 49.2M
README.md
README.mdREADME.md

Documentation for dataset contents, schema, usage, and support.

  • File Size: 11.10 KB
checksum.txt
checksum.txtchecksum.txt

SHA-256 checksums for verifying file integrity.

  • File Size: 162 Bytes

Response Schema

This section describes the structure of the data returned from the Advance IP to Location MMDB file. Each field is detailed with its type, meaning, and example values to help you interpret responses and integrate them into your applications.

1. db-ip-geolocation.mmdb

This file provides geolocation data for IPv4 and IPv6 ranges at the city level. Each response includes multilingual country, state, district, and city details, geographic coordinates, time zone, GeoNames ID, and connection type. It also includes accuracy radius, confidence level, and U.S.-only DMA codes for finer, more granular detail.

2. Field Reference

The following reference lists all fields available in the MMDB response. Each entry includes the field path, its description, data type, and example value to help you understand how to parse and integrate the data.

Showing 2 of 35
Select a field to view details
FieldTypeDescriptionExample
locationobject
location.countryobjectThe name of the country in multiple languages.
location.country.continentobjectThe name of the continent in multiple languages.
location.country.continent.nameobjectThe name of the continent in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).North America
location.country.continent.codestringThe two-letter code representing the continent.NA
location.country.nameobjectThe name of the country in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).United States
location.country.name_officialobjectThe official name of the country in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).United States of America
location.country.code2stringThe two-letter code representing the country.US
location.country.code3stringThe three-letter code representing the country.USA
location.country.code_iocstringThe International Olympic Committee (IOC) code representing the country.USA
location.country.capitalobjectThe capital city of the country in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).Washington, D.C.
location.country.currencyobjectThe currency used in the country.
location.country.currency.codestringThe three-letter code representing the currency, following ISO 4217 standards.USD
location.country.currency.symbolstringThe symbol representing the currency.$
location.country.currency.namestringThe name of the currency.United States Dollar
location.country.metadataobject Additional metadata about the country.
location.country.metadata.calling_codestringThe international calling code for the country.+1
location.country.metadata.tldstringThe top-level domain (TLD) for the country..us
location.country.metadata.languagesstringThe languages spoken in the country.ru,en,es etc
location.stateobjectThe name of the state in multiple languages.
location.state.nameobjectThe name of the state in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).California
location.state.codestringThe two-letter code representing the state or province with country-code, following ISO 3166-2 standards.CA
location.districtobjectThe name of the district in multiple languages.
location.district.nameobjectThe name of the district in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).Santa Clara County
location.cityobjectThe name of the city in multiple languages.
location.city.nameobjectThe name of the city in multiple languages (english, german, russian, korean, portuguese, japanese, persian, french, chinese, spanish, czech, italian).Mountain View
location.coordinatesobjectThe geographical coordinates of the location associated with the IP range.
location.coordinates.latitudenumberThe latitude coordinate of the location associated with the IP range.37.3861
location.coordinates.longitudenumberThe longitude coordinate of the location associated with the IP range.-122.0838
location.zipcodestringThe postal code for the location associated with the IP range.94043
location.geoname_idnumberThe GeoNames ID for the location associated with the IP range.5375480
location.accuracy_radiusnumberThe accuracy radius in kilometers for the location associated with the IP range.20
location.confidencenumberThe confidence level (0-100) of the location data associated with the IP range.95
location.dma_codenumberThe Designated Market Area (DMA) code for the location associated with the IP range.807
time_zonestringThe time zone name for the location associated with the IP range.America/Los_Angeles
connection_typestringThe type of internet connection associated with the IP range (e.g., dialup, cable, DSL, fiber, etc.).cable

2. Example Records

Example
{
  "connection_type": "Cable",
  "location": {
    "accuracy_radius": "8.086",
    "city": {
      "name": {
        "cs": "Bílé město",
        "de": "Weiße Stadt",
        "en": "White City",
        "es": "Bílé město",
        "fa": "",
        "fr": "Ville Blanche",
        "it": "Città Bianca",
        "ja": "ホワイトシティ",
        "ko": "",
        "pt": "",
        "ru": "Уайт-Сити",
        "zh": "白城"
      }
    },
    "confidence": "high",
    "coordinates": {
      "latitude": "40.563718",
      "longitude": "-111.860892"
    },
    "country": {
      "capital": {
        "cs": "",
        "de": "",
        "en": "Washington, D.C.",
        "es": "",
        "fa": "",
        "fr": "",
        "it": "",
        "ja": "",
        "ko": "",
        "pt": "",
        "ru": "",
        "zh": ""
      },
      "code2": "US",
      "code3": "USA",
      "code_ioc": "USA",
      "continent": {
        "code": "NA",
        "name": {
          "cs": "Severní Amerika",
          "de": "Nordamerika",
          "en": "North America",
          "es": "Norteamérica",
          "fa": " امریکای شمالی",
          "fr": "Amérique du Nord",
          "it": "America del Nord",
          "ja": "北アメリカ",
          "ko": "América do Norte",
          "pt": "América Do Norte",
          "ru": "Северная Америка",
          "zh": "北美洲"
        }
      },
      "currency": {
        "code": "USD",
        "name": {
          "en": "US Dollar"
        },
        "symbol": "$"
      },
      "metadata": {
        "calling_code": "+1",
        "languages": "en-US,es-US,haw,fr",
        "tld": ".us"
      },
      "name": {
        "cs": "Spojené státy americké",
        "de": "USA",
        "en": "United States",
        "es": "Estados Unidos",
        "fa": "ایالات متحدهٔ امریکا",
        "fr": "États-Unis",
        "it": "Stati Uniti d'America",
        "ja": "アメリカ合衆国",
        "ko": "Estados Unidos",
        "pt": "Estados Unidos",
        "ru": "США",
        "zh": "美国"
      },
      "name_official": {
        "cs": "",
        "de": "",
        "en": "United States of America",
        "es": "",
        "fa": "",
        "fr": "",
        "it": "",
        "ja": "",
        "ko": "",
        "pt": "",
        "ru": "",
        "zh": ""
      }
    },
    "district": {
      "name": {
        "cs": "Slané jezero",
        "de": "Salt Lake",
        "en": "Salt Lake County",
        "es": "Comté de Salt Lake",
        "fa": "شهرستان سالت‌لیک، یوتا",
        "fr": "Comté de Salt Lake",
        "it": "Contea di Salt Lake",
        "ja": "ソルトレイク郡",
        "ko": "",
        "pt": "Condado de Salt Lake",
        "ru": "Солт-Лейк",
        "zh": "鹽湖縣"
      }
    },
    "dma_code": "770",
    "geoname_id": "5784731",
    "state": {
      "code": "US-UT",
      "name": {
        "cs": "Utahu",
        "de": "Utah",
        "en": "Utah",
        "es": "Utah",
        "fa": "یوتا",
        "fr": "Utah",
        "it": "Utah",
        "ja": "ユタ州",
        "ko": "Utá",
        "pt": "Utá",
        "ru": "Юта",
        "zh": "犹他州"
      }
    },
    "zipcode": "84094"
  },
  "time_zone": "America/Denver"
}

Database Integrity & Authenticity Verification

There are two methods of verifying the integrity and authenticity of our Database:

1. Using the Signature File (Recommended)

IPGeolocation.io signs every database release to ensure its authenticity and integrity. This allows customers to verify that a downloaded Advance IP to Location database file originates directly from IPGeolocation.io and has not been altered, corrupted, or tampered with during transfer or storage.

Each database update includes a corresponding signature file, generated using our private signing key. Customers can validate the database using the provided public verification key. To verify a database file, you need:

  1. Database file (the downloaded archive)
  2. Signature file (the matching signature for that archive)
  3. Public key (public-key.pem)

These files are available via official IPGeolocation.io download endpoints and are also shared in database update notifications.

2. Using the Checksum File (Legacy)

Each database archive includes a checksum.txt file containing the SHA-256 checksums for the files packaged in the archive. You can use this file to validate that the extracted contents are complete and unchanged.

Data Format & Constraints

  • All fields defined in the schema are always present in the Advance IP to Location MMDB response.
  • Fields may contain empty strings (""), but never null, so null checks are not required.
  • Place names such as countries, states, districts, and cities are available in multiple translations.
  • All text values are encoded in UTF-8.
  • Field names and response structure remain stable across updates for backward compatibility.

Database Updates & Delivery

When you subscribe to our Advance IP to Location database, we'll send you static download links. These links never change, so you can use them both for your initial download and for all future updates. You will receive:

  1. Database Archive URL : downloads the latest release of your subscribed database (CSV, MMDB or requested formats).
  2. Signature File URL : downloads the matching signature file for the latest release (used for authenticity verification).
  3. Public Key URL : downloads the public verification key (used with the signature file).
  4. Status Endpoint URL : returns the database's most recent update timestamp.

Our databases are updated continuously and shipped on a daily or weekly cycle depending on your plan, ensuring you always have access to the most current data. Each time your subscribed dataset is updated, you'll also receive an email notification so you don't miss a release.

For automated workflows, you can check our status endpoint to see the last update timestamp. When the date changes, simply re-fetch the archive using your static download URL to pull the latest version into your system.

Subscribe to Our Newsletter

Get the latest in geolocation tech, straight to your inbox.