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 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.gzStandardized country and continent metadata with codes, currency, calling codes, TLDs, and languages.
- File Size: 9.67 KB
- Entries: 254
- Fields: 15
db-place.csv.gzMultilingual place names for cities, districts, states, countries, and continents.
- File Size: 13.09 MB
- Entries: 343.5K
- Fields: 13
db-ip-location.csv.gzIP ranges mapped to locations with place IDs (for multilingual responses), ZIP codes, coordinates, time zone, and connection type.
- File Size: 543.18 MB
- Entries: 38.1M
- Fields: 16
README.mdDocumentation for dataset contents, schema, usage, and support.
- File Size: 9.79 KB
checksum.txtSHA-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.
| Field | Type | Description | Can be empty? | Example |
|---|---|---|---|---|
| start_ip | string | The starting IP address of the range in IPv4 or IPv6 format. | No | 192.168.0.1 |
| end_ip | string | The ending IP address of the range in IPv4 or IPv6 format. | No | 192.168.0.255 |
| country_id | number | The unique identifier for the country associated with the IP range. | No | 192 |
| state_place_id | number | The unique identifier for the state or province associated with the IP range. | Yes | 5332921 |
| state_code | string | The two-letter code representing the state or province with country-code, following ISO 3166-2 standards. | Yes | CA |
| district_place_id | number | The unique identifier for the district associated with the IP range. | Yes | 5332923 |
| city_place_id | number | The unique identifier for the city associated with the IP range. | Yes | 5375480 |
| accuracy_radius | number | The accuracy radius in kilometers for the location associated with the IP range. | No | 20 |
| confidence | number | The confidence level (0-100) of the location data associated with the IP range. | No | 95 |
| dma_code | number | The Designated Market Area (DMA) code for the location associated with the IP range. | Yes | 807 |
| zip_code | string | The postal code for the location associated with the IP range. | Yes | 94043 |
| latitude | number | The latitude coordinate of the location associated with the IP range. | No | 37.3861 |
| longitude | number | The longitude coordinate of the location associated with the IP range. | No | -122.0838 |
| geo_name_id | number | The GeoNames ID for the location associated with the IP range. | Yes | 5375480 |
| time_zone_name | string | The time zone name for the location associated with the IP range. | No | America/Los_Angeles |
| connection_type | string | The type of internet connection associated with the IP range (e.g., dialup, cable, DSL, fiber, etc.). | Yes | cable |
1. Example Records
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
82.16.160.21,82.16.160.21,58,478,GB-WLS,2152,2152,7.869,high,,CF24,51.48371,-3.1681,6948194,Europe/London,Cable
146.115.56.123,146.115.56.123,172,384,US-MA,4326,28365,8.767,medium,506,01702,42.28003,-71.41619,9687727,America/New_York,Cable
68.149.54.184,68.149.54.184,29,604,CA-AB,14554,14554,6.223,high,,T5H 2K3,53.557425,-113.486384,6068816,America/Edmonton,Cable
86.131.67.6,86.131.67.6,58,360,GB-ENG,1387,1650,4.535,high,,W5 4NS,51.499847,-0.299952,6954804,Europe/London,DSL
2a02:ab04:1b7:e000::7,2a02:ab04:1b7:e000::7,199,240078,SK-BL,222584,29782,8.867,high,,811 06,48.14777,17.10716,10110214,Europe/Bratislava,Fixed Broadband
172.112.43.77,172.112.43.77,172,362,US-CA,4426,32016,5.806,high,803,92335,34.08379,-117.46738,5333000,America/Los_Angeles,Cable
99.239.25.38,99.239.25.38,29,597,CA-ON,240079,209032,4.956,high,,M5G,43.65483,-79.38845,9884349,America/Toronto,Cable
45.205.241.74,45.205.241.74,172,297,US-NJ,5706,28607,5.172,high,504,08542,40.35039,-74.65714,5095371,America/New_York,Fixed Broadband
107.10.114.43,107.10.114.43,172,592,US-WI,6676,4386,2.613,high,658,54303,44.5432,-88.06076,5258324,America/Chicago,Cable
116.97.40.32,116.97.40.32,205,240080,VN-23,240081,3077,5.545,high,,45100,18.34869,105.90537,10275324,Asia/Bangkok,DSL2. 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.
| Field | Type | Description | Can be empty? | Example |
|---|---|---|---|---|
| id | number | The unique identifier for the place. | No | 5375480 |
| place_english | string | The name of the place in English. | No | Mountain View |
| place_german | string | The name of the place in German. | Yes | Mountain View |
| place_russian | string | The name of the place in Russian. | Yes | Маунтин-Вью |
| place_korean | string | The name of the place in Korean. | Yes | 마운틴 뷰 |
| place_portuguese | string | The name of the place in Portuguese. | Yes | Mountain View |
| place_japanese | string | The name of the place in Japanese. | Yes | マウンテンビュー |
| place_persian | string | The name of the place in Farsi. | Yes | ماونتین ویو |
| place_french | string | The name of the place in French. | Yes | Mountain View |
| place_chinese | string | The name of the place in Chinese. | Yes | 山景城 |
| place_spanish | string | The name of the place in Spanish. | Yes | Mountain View |
| place_czech | string | The name of the place in Czech. | Yes | Mountain View |
| place_italian | string | The name of the place in Italian. | Yes | Mountain View |
2. Example Records
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
209032,Bay Street Corridor,Bay Street Korridor,Коридор Остров-стрит,,,ベイ・ストリート・コリドー,,Corridor de la rue Bay,湾街走廊,Koridor Bay Street,Koridor Bay Street,Corridoio di Bay Street
5,Asia,Asien,Азия,Ásia,Ásia,アジア, آسیا,Asie,亚洲,Asia,Asie,Asia
592,Wisconsin,Wisconsin,Висконсин,위스콘신 주,,ウィスコンシン州,ویسکانسین,Wisconsin,威斯康辛州,Wisconsin,Wisconsin,Wisconsin
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
29782,Bratislava,Bratislava,Братислава,브라티슬라바,Bratislava,ブラチスラヴァ,براتیسلاو,Bratislava,布拉迪斯拉发,Bratislava,Bratislava,Bratislava
362,California,Kalifornien,Калифорния,Califórnia,Califórnia,カリフォルニアだ,کالیفرنیا,Californie,加州,California,Kalifornie,California
240018,United States of America,,,,,,,,,,,
240019,"Washington, D.C.",,,,,,,,,,,
604,Alberta,Alberta,Альберта,앨버타 주,,アルバータ州,آلبرتا,Alberta,艾伯塔,Alberta,Alberta,Alberta
28607,Princeton,Princeton,Принстон,,,プリンストン,پرینستون، ایندیانا,Princeton,普林斯顿,Princetonu,Princetonu,Princeton
4386,Howard,Howard,Хауард,,Condado de Howard,ハワード郡,شهرستان هاوارد، مریلند,Comté de Howard,霍華德縣,Howarda,Howarda,Howard
28,United States,USA,США,Estados Unidos,Estados Unidos,アメリカ合衆国,ایالات متحدهٔ امریکا,États-Unis,美国,Estados Unidos,Spojené státy americké,Stati Uniti d'America
30,Vietnam,Vietnam,Вьетнам,Vietnã,Vietnã,ベトナム,ویتنام,Vietnam,越南,Vietnam,Vietnam,Vietnam
1650,London,London,Лондон,London,,ロンドン,,London,伦敦,London,Londýn,Londra
32016,Fontana,Fontana,Фонтана,폰태나,,フォンタナ,فونتانا، کالیفرنیا,Fontana,方塔納,Fontana,Fontana,Fontana
36,United Kingdom,Vereinigtes Königreich,Великобритания,Reino Unido,Reino Unido,イギリス,بریتانیا,Royaume-Uni,英国,Reino Unido,Spojené království Velké Británie a Severního Irska,Regno Unito
28365,Framingham,Framingham,Фрамингем,프레이밍햄,,フレイミングハム,فرامینگهام، ماساچوست,Framingham,弗雷明翰,Framinghamu,Framinghamu,Framingham
240040,Slovak Republic,,,,,,,,,,,
222584,Bratislava I,Bratislava I,Братислава I,,,ブラチスラヴァ,,Bratislava Ier,布拉迪斯拉发一世,Bratislava I,Bratislava,Bratislava I
5706,Mercer County,Mercer,Мерсер,,Condado de Mercer,マーサー郡,شهرستان مرسر، نیوجرسی,Comté de Mercer,默瑟县,Мерсер,Mercer County,Contea di Mercer
240046,Socialist Republic of Viet Nam,,,,,,,,,,,
384,Massachusetts,Massachusetts,Массачусетс,매사추세츠 주,,マサチューセッツ州,ماساچوست,Massachusetts,麻薩諸塞州,Massachusetts,Massachusetts,Massachusetts
239922,United Kingdom of Great Britain and Northern Ireland,,,,,,,,,,,
6676,Brown County,Brown County,Браун,,Condado de Brown,ブラウン郡,شهرستان براون، تگزاس,Comté de Brown,布朗縣,Браун,Brown County (Texas),Contea di Brown
4326,Middlesex,Middlesex,Мидлсекс,,Condado de Middlesex,ミドルセックス郡,شهرستان میدلسکس، ماساچوست,Comté de Middlesex,米德爾塞克斯縣,Middlesex,Middlesex,Middlesex
65,Canada,Kanada,Канада,Canadá,Canadá,カナダ,کانادا,Canada,加拿大,Canadá,Kanada,Canada
297,New Jersey,New Jersey,Нью-Джерси,Nova Jérsia,Nova Jérsia,ニュージャージー州,نیو جرسی,New Jersey,新泽西州,Nueva Jersey,New Jersey,New Jersey
240080,Hà Tĩnh Province,,,,,,,,,,,
3077,Ha Tinh,Ha Thin,Хатинь,,,ハティン,,Province de Hà Tĩnh,河亭市,Ha Tinh,Ha Tinh,Ha Tinh
2152,Cardiff,Cardiff,Кардифф,,,カーディフ,,Cardiff,加的夫,Cardiff,Cardiff,Cardiff
1387,Greater London,Großraum London,Гранд Лондон,,,大ロンドン市,,Grand Londres,大倫敦地區,londýnských,londýnských,Greater Londra
240081,Thành Phố Hà Tĩnh,,,,,,,,,,,
29782,Bratislava,Bratislava,Братислава,브라티슬라바,Bratislava,ブラチスラヴァ,براتیسلاو,Bratislava,布拉迪斯拉发,Bratislava,Bratislava,Bratislava
1254,Hanoi,Hanoi,Ханой,,,ハノイ,,Hanoï,河内,Hanoj,Hanoj,Hanoi
106,Slovakia,Slowakei (Slowakische Republik),Словакия,Eslováquia,Eslováquia,スロバキア (スロバキア共和国),اسلواکی,Slovaquie,斯洛伐克共和国,Eslovaquia,Slovensko,Slovacchia
4588,Ottawa,Ottawa,Оттава,Otava,Condado de Ottawa,オタワ,شهرستان اتاوا، اکلاهما,Ottawa,渥太華縣,Ottawa,Ottawa,Ottawa
478,Wales,Wales,Уэльс,,,ウェールズ,,Pays de Galles,威尔士,Gales,Wales,Galles
14554,Edmonton,Edmonton,Эдмонтон,Edmonton,,エドモントン,,Edmonton,埃德蒙顿,Edmonton,Edmonton,Edmonton
4426,San Bernardino County,San Bernardino,Сан-Бернардино,샌버너디노 군,Condado de San Bernardino,サンバーナーディーノ郡,شهرستان سن برناردینو، کالیفرنیا,Comté de San Bernardino,聖貝納迪諾縣,Сан-Бернардино,San Bernardino County,Contea di San Bernardino
240078,Bratislava Region,,,,,,,,,,,
597,Ontario,Ontario,Онтарио,Ontário,Ontário,オンタリオ州,انتاریو,Ontario,安大略,V Ontariu,V Ontariu,Ontario
1650,London,London,Лондон,London,,ロンドン,,London,伦敦,London,Londýn,Londra
240079,Toronto county,,,,,,,,,,,
360,England,England,Англия,Inglaterra,Inglaterra,イングランド,انگلستان,Angleterre,英格兰,Inglaterra,Anglie,Inghilterra3. 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.
| Field | Type | Description | Can be empty? | Example |
|---|---|---|---|---|
| id | number | The unique identifier for the country. | No | 192 |
| continent_code | string | The continent code associated with the country. | No | NA |
| continent_name_place_id | number | The unique identifier for the continent place. | No | 6255148 |
| country_code2 | string | The ISO 3166-1 alpha-2 code of the country. | No | US |
| country_code3 | string | The ISO 3166-1 alpha-3 code of the country. | No | USA |
| country_code_ioc | string | The IOC country code. | No | USA |
| country_name_place_id | number | The unique identifier for the country place. | No | 6252001 |
| country_name_official_place_id | number | The unique identifier for the official country place. | No | 6252001 |
| country_capital_place_id | number | The unique identifier for the capital place. | No | 5375480 |
| currency_code | string | The ISO 4217 currency code of the country. | No | USD |
| currency_name | string | The name of the currency used in the country. | No | United States Dollar |
| currency_symbol | string | The symbol of the currency used in the country. | No | $ |
| calling_code | string | The international calling code of the country. | No | +1 |
| tld | string | The top-level domain (TLD) of the country. | No | .us |
| languages | string | The official languages spoken in the country, represented as a comma-separated list of ISO 639-1 codes. | No | en,es |
3. Example Records
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
172,NA,6,US,USA,USA,28,240018,240019,USD,US Dollar,$,+1,.us,"en-US,es-US,haw,fr"
58,EU,7,GB,GBR,GBR,36,239922,1650,GBP,Pound Sterling,£,+44,.uk,"en-GB,cy-GB,gd"
199,EU,7,SK,SVK,SVK,106,240040,29782,EUR,Euro,€,+421,.sk,"sk,hu"
205,AS,5,VN,VNM,VIE,30,240046,1254,VND,Vietnamese Dong,₫,+84,.vn,"vi,en,fr,zh,km"
29,NA,6,CA,CAN,CAN,65,65,4588,CAD,Canadian Dollar,C$,+1,.ca,"en-CA,fr-CA,iu"4. File Relationship Diagram
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- File Size: 2.92 GB
- Entries: 38.1M
README.mdDocumentation for dataset contents, schema, usage, and support.
- File Size: 11.10 KB
checksum.txtSHA-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.
| Field | Type | Description | Example |
|---|---|---|---|
location | object | ||
location.country | object | The name of the country in multiple languages. | |
location.country.continent | object | The name of the continent in multiple languages. | |
location.country.continent.name | object | The name of the continent in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian). | North America |
location.country.continent.code | string | The two-letter code representing the continent. | NA |
location.country.name | object | The name of the country in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian). | United States |
location.country.name_official | object | The 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.code2 | string | The two-letter code representing the country. | US |
location.country.code3 | string | The three-letter code representing the country. | USA |
location.country.code_ioc | string | The International Olympic Committee (IOC) code representing the country. | USA |
location.country.capital | object | The 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.currency | object | The currency used in the country. | |
location.country.currency.code | string | The three-letter code representing the currency, following ISO 4217 standards. | USD |
location.country.currency.symbol | string | The symbol representing the currency. | $ |
location.country.currency.name | string | The name of the currency. | United States Dollar |
location.country.metadata | object | Additional metadata about the country. | |
location.country.metadata.calling_code | string | The international calling code for the country. | +1 |
location.country.metadata.tld | string | The top-level domain (TLD) for the country. | .us |
location.country.metadata.languages | string | The languages spoken in the country. | ru,en,es etc |
location.state | object | The name of the state in multiple languages. | |
location.state.name | object | The name of the state in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian). | California |
location.state.code | string | The two-letter code representing the state or province with country-code, following ISO 3166-2 standards. | CA |
location.district | object | The name of the district in multiple languages. | |
location.district.name | object | The name of the district in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian). | Santa Clara County |
location.city | object | The name of the city in multiple languages. | |
location.city.name | object | The name of the city in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian). | Mountain View |
location.coordinates | object | The geographical coordinates of the location associated with the IP range. | |
location.coordinates.latitude | number | The latitude coordinate of the location associated with the IP range. | 37.3861 |
location.coordinates.longitude | number | The longitude coordinate of the location associated with the IP range. | -122.0838 |
location.zipcode | string | The postal code for the location associated with the IP range. | 94043 |
location.geoname_id | number | The GeoNames ID for the location associated with the IP range. | 5375480 |
location.accuracy_radius | number | The accuracy radius in kilometers for the location associated with the IP range. | 20 |
location.confidence | number | The confidence level (0-100) of the location data associated with the IP range. | 95 |
location.dma_code | number | The Designated Market Area (DMA) code for the location associated with the IP range. | 807 |
time_zone | string | The time zone name for the location associated with the IP range. | America/Los_Angeles |
connection_type | string | The type of internet connection associated with the IP range (e.g., dialup, cable, DSL, fiber, etc.). | cable |
2. Example Records
{
"connection_type": "Cable",
"location": {
"accuracy_radius": "7.869",
"city": {
"name": {
"cs": "Cardiff",
"de": "Cardiff",
"en": "Cardiff",
"es": "Cardiff",
"fa": "",
"fr": "Cardiff",
"it": "Cardiff",
"ja": "カーディフ",
"ko": "",
"pt": "",
"ru": "Кардифф",
"zh": "加的夫"
}
},
"confidence": "high",
"coordinates": {
"latitude": "51.48371",
"longitude": "-3.1681"
},
"country": {
"capital": {
"cs": "Londýn",
"de": "London",
"en": "London",
"es": "London",
"fa": "",
"fr": "London",
"it": "Londra",
"ja": "ロンドン",
"ko": "London",
"pt": "",
"ru": "Лондон",
"zh": "伦敦"
},
"code2": "GB",
"code3": "GBR",
"code_ioc": "GBR",
"continent": {
"code": "EU",
"name": {
"cs": "Evropa",
"de": "Europa",
"en": "Europe",
"es": "Europa",
"fa": " اروپا",
"fr": "Europe",
"it": "Europa",
"ja": "ヨーロッパ",
"ko": "Europa",
"pt": "Europa",
"ru": "Европа",
"zh": "欧洲"
}
},
"currency": {
"code": "GBP",
"name": {
"en": "Pound Sterling"
},
"symbol": "£"
},
"metadata": {
"calling_code": "+44",
"languages": "en-GB,cy-GB,gd",
"tld": ".uk"
},
"name": {
"cs": "Spojené království Velké Británie a Severního Irska",
"de": "Vereinigtes Königreich",
"en": "United Kingdom",
"es": "Reino Unido",
"fa": "بریتانیا",
"fr": "Royaume-Uni",
"it": "Regno Unito",
"ja": "イギリス",
"ko": "Reino Unido",
"pt": "Reino Unido",
"ru": "Великобритания",
"zh": "英国"
},
"name_official": {
"cs": "",
"de": "",
"en": "United Kingdom of Great Britain and Northern Ireland",
"es": "",
"fa": "",
"fr": "",
"it": "",
"ja": "",
"ko": "",
"pt": "",
"ru": "",
"zh": ""
}
},
"district": {
"name": {
"cs": "Cardiff",
"de": "Cardiff",
"en": "Cardiff",
"es": "Cardiff",
"fa": "",
"fr": "Cardiff",
"it": "Cardiff",
"ja": "カーディフ",
"ko": "",
"pt": "",
"ru": "Кардифф",
"zh": "加的夫"
}
},
"dma_code": "",
"geoname_id": "6948194",
"state": {
"code": "GB-WLS",
"name": {
"cs": "Wales",
"de": "Wales",
"en": "Wales",
"es": "Gales",
"fa": "",
"fr": "Pays de Galles",
"it": "Galles",
"ja": "ウェールズ",
"ko": "",
"pt": "",
"ru": "Уэльс",
"zh": "威尔士"
}
},
"zipcode": "CF24"
},
"time_zone": "Europe/London"
}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:
- Database file (the downloaded archive)
- Signature file (the matching signature for that archive)
- 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:
- Database Archive URL : downloads the latest release of your subscribed database (CSV, MMDB or requested formats).
- Signature File URL : downloads the matching signature file for the latest release (used for authenticity verification).
- Public Key URL : downloads the public verification key (used with the signature file).
- 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.
