IP Location Database (Standard) Documentation


Overview

Our Geo Standard IP to Geolocation Database provides you with accurate city-level geolocation data for both IPv4 and IPv6 addresses. It includes standard geolocation data such as country, state, district, city, ZIP code, geographic coordinates, time zone, and GeoNames ID. If your use case is more critical and you need more granular details on location, please check out our advanced IP to location database.

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.

Behind the scenes, our crawlers and pipelines run 24/7, and database updates ship on daily and weekly cycles 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: 421.71 MB
  • Entries: 41.0M
  • Fields: 12
  • Last Updated:
MMDB
MMDBMMDB
  • File Size: 516.29 MB
  • Entries: 41.0M
  • Fields: 12
  • Last Updated:

CSV Database Documentation


1. Overview

The CSV version of our Standard 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 Standard 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.68 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: 28.02 MB
  • Entries: 417.4K
  • 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, and time zone.

  • File Size: 393.67 MB
  • Entries: 41.0M
  • Fields: 12
README.md
README.mdREADME.md

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

  • File Size: 9.11 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 Standard 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, and GeoNames ID.

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_codestringISO 3166-2 subdivision code, including the country prefixYesUS-CA
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
zip_codestringThe postal code for the location associated with the IP range.Yes94043
latitudestringThe latitude coordinate of the location associated with the IP range.No37.3861
longitudestringThe longitude coordinate of the location associated with the IP range.No-122.0838
geo_name_idstringThe 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

I. Example Records

Example
start_ip,end_ip,country_id,state_place_id,state_code,district_place_id,city_place_id,zip_code,latitude,longitude,geo_name_id,time_zone_name
103.6.186.88,103.6.186.88,76,292,IN-MH,3773,102257,421301,19.24033,73.13054,1268290,Asia/Kolkata
191.215.86.233,191.215.86.233,172,363,US-CA,4806,4451,95814,38.57944,-121.49085,10286068,America/Los_Angeles
208.89.223.10,208.89.223.39,172,401,US-WA,4501,24100,98164,47.60621,-122.33207,5809844,America/Los_Angeles
2601:145:c200:3f5c:571f:945:644f:ca5d,2601:145:c200:3f5c:571f:945:644f:ca5d,172,597,US-MD,4548,37497,21032,39.02389,-76.61838,7135382,America/New_York
2.194.224.2,2.194.224.2,80,360,IT-25,242115,224395,20121,45.4685,9.1824,6485634,Europe/Rome
201.132.155.130,201.132.155.130,117,1314,MX-SIN,146612,8815,80000,24.80907,-107.39401,12193084,America/Mazatlan
79.208.240.75,79.208.240.75,41,239056,DE-HE,41277,13901,64283,49.86953,8.65069,6530739,Europe/Berlin
180.169.104.144,180.169.105.27,35,265,CN-SH,240308,265,201199,31.11246,121.38162,1800480,Asia/Shanghai
119.93.34.118,119.93.34.118,133,1175,PH-00,9064,22843,1100,14.64879,121.05094,1692192,Asia/Manila
61.227.45.1,61.227.45.1,202,333743,TW-KHH,300,300,807,22.64834,120.32625,7501975,Asia/Taipei

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

I. 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
6,Asia,Asien,Азия,아시아,Ásia,アジア,آسیا,Asie,亚洲,Asia,Asie,Asia
7,North America,Nordamerika,Северная Америка,북아메리카,América do Norte,北アメリカ,آمریکای شمالی,Amérique du Nord,北美洲,América del Norte,Severní Amerika,America del Nord
8,Europe,Europa,Европа,유럽,Europa,ヨーロッパ,اروپا,Europe,欧洲,Europa,Evropa,Europa
265,Shanghai,Schanghai,Шанхай,상하이,Xangai,上海,شانگهای,Shanghai,上海,Shanghái,Šanghaj,Shanghai
266,Beijing,Peking,Пекин,베이징,Pequim,北京,پکن,Pékin,北京,Pekín,Peking,Pechino
3722,New Delhi,Neu-Delhi,Нью-Дели,뉴델리,Nova Deli,ニューデリー,دهلی نو,New Delhi,新德里,Nueva Delhi,Nové Dillí,Nuova Delhi
224395,Brera,Brera,Брера,브레라,Brera,ブレラ,بررا,Brera,布雷拉,Brera,Brera,Brera
13,China,China,Китай,중국,China,中国,چین,Chine,中国,China,Čína,Cina
16,India,Indien,Индия,인도,Índia,インド,هند,Inde,印度,India,Indie,India
401,Washington,Washington,Вашингтон,워싱턴,Washington,ワシントン,واشنگتن,Washington,华盛顿,Washington,Washington,Washington
4501,King County,King County,Округ Кинг,킹 카운티,Condado de King,キング郡,شهرستان کینگ,Comté de King,金县,Condado de King,King County,King County
1175,National Capital Region,National Capital Region,Национальный столичный регион,국가 수도권,Região da Capital Nacional,首都圏,منطقه پایتخت ملی,Région de la capitale nationale,国家首都区,Región de la Capital Nacional,Národní hlavní město,Regione della capitale nazionale
24,Germany,Deutschland,Германия,독일,Alemanha,ドイツ,آلمان,Allemagne,德国,Alemania,Německo,Germania
26,Italy,Italien,Италия,이탈리아,Itália,イタリア,ایتالیا,Italie,意大利,Italia,Itálie,Italia
240027,United States of America,Vereinigte Staaten von Amerika,Соединённые Штаты Америки,미국,Estados Unidos da América,アメリカ合衆国,ایالات متحده آمریکا,États-Unis d'Amérique,美利坚合众国,Estados Unidos de América,Spojené státy americké,Stati Uniti d'America
240028,"Washington, D.C.","Washington, D.C.",Вашингтон,워싱턴 D.C.,"Washington, D.C.",ワシントンD.C.,واشنگتن دی.سی.,"Washington, D.C.",华盛顿哥伦比亚特区,"Washington, D.C.","Washington, D.C.","Washington, D.C."
1314,Sinaloa,Sinaloa,Синалоа,시날로아,Sinaloa,シナロア,سینالوآ,Sinaloa,锡那罗亚,Sinaloa,Sinaloa,Sinaloa
292,Maharashtra,Maharashtra,Махараштра,마하라슈트라,Maharashtra,マハラシュトラ,ماهاراشترا,Maharashtra,马哈拉施特拉邦,Maharashtra,Maharashtra,Maharashtra
24100,Seattle,Seattle,Сиэтл,시애틀,Seattle,シアトル,سیتل,Seattle,西雅图,Seattle,Seattle,Seattle
38,Taiwan,Taiwan,Тайвань,대만,Taiwan,台湾,تایوان,Taïwan,台湾,Taiwán,Tchaj-wan,Taiwan
39,United States,Vereinigte Staaten,Соединенные Штаты,미국,Estados Unidos,アメリカ合衆国,ایالات متحده آمریکا,États-Unis,美国,Estados Unidos,Spojené státy americké,Stati Uniti
40,Philippines,Philippinen,Филиппины,필리핀,Filipinas,フィリピン,فیلیپین,Philippines,菲律宾,Filipinas,Filipíny,Filippine
553,Berlin,Berlin,Берлин,베를린,Berlim,ベルリン,برلین,Berlin,柏林,Berlín,Berlín,Berlino
239910,People’s Republic of China,Volksrepublik China,Китайская Народная Республика,중화인민공화국,República Popular da China,中華人民共和国,جمهوری خلق چین,République populaire de Chine,中华人民共和国,República Popular China,Čínská lidová republika,Repubblica Popolare Cinese
239915,Federal Republic of Germany,Bundesrepublik Deutschland,Федеративная Республика Германия,독일 연방 공화국,República Federal da Alemanha,ドイツ連邦共和国,جمهوری فدرال آلمان,République fédérale d’Allemagne,德意志联邦共和国,República Federal de Alemania,Německá federální republika,Repubblica federale di Germania
300,Kaohsiung,Kaohsiung,Гаосюн,가오슝,Kaohsiung,高雄,کاوهسیونگ,Kaohsiung,高雄,Kaohsiung,Kaohsiung,Kaohsiung
239993,Republic of the Philippines,Republik der Philippinen,Филиппины,필리핀 공화국,República das Filipinas,フィリピン共和国,جمهوری فیلیپین,République des Philippines,菲律宾共和国,República de Filipinas,Filipínská republika,Repubblica delle Filippine
333743,Takao,Takao,Такао,타카오,Takao,高尾,تاکائو,Takao,高尾,Takao,Takao,Takao
146612,Culiacán,Culiacán,Кульякан,쿨리아칸,Culiacán,クリャカン,کولیاکان,Culiacán,库利亚坎,Culiacán,Culiacán,Culiacán
240308,Shanghai Shi,Shanghai,Шанхай,상하이,Xangai,上海市,شانگهای,Shanghai,上海市,Shanghái,Šanghaj,Shanghai
240053,Republic of China,Republik China,Китайская Республика,중화민국,República da China,中華民国,جمهوری چین,République de Chine,中华民国,República de China,Čínská republika,Repubblica di Cina
22843,Quezon City,Quezon City,Кесон-Сити,케손 시,Quezon City,ケソン市,کویزن سیتی,Quezon City,奎松市,Ciudad de Quezon,Quezon City,Quezon City
41277,Darmstadt,Darmstadt,Дармштадт,다름슈타트,Darmstadt,ダルムシュタット,دارمشتات,Darmstadt,达姆施塔特,Darmstadt,Darmstadt,Darmstadt
3773,Thane,Thane,Тхане,타네,Thane,タネ,تانه,Thane,塔内,Thane,Thane,Thane
242115,Città metropolitana di Milano,Metropolstadt Mailand,Миланская агломерация,밀라노 광역 도시권,Cidade metropolitana de Milão,ミラノ都市圏,منطقه شهری میلان,Città metropolitana di Milano,米兰都会区,Ciudad metropolitana de Milán,Metropolitní město Milán,Città metropolitana di Milano
67,Mexico,Mexiko,Мексика,멕시코,México,メキシコ,مکزیک,Mexique,墨西哥,México,Mexiko,Messico
4548,Anne Arundel County,Anne Arundel County,Округ Энн-Арундел,앤 아룬델 카운티,Condado de Anne Arundel,アン・アーンドル郡,شهرستان آن آروندل,Comté d'Anne Arundel,安妮·阿伦德尔县,Condado de Anne Arundel,Okres Anne Arundel,Contea di Anne Arundel
4806,Sacramento County,Sacramento County,Округ Сакраменто,새크라멘토 카운티,Condado de Sacramento,サクラメント郡,شهرستان ساکرامنتو,Comté de Sacramento,萨克拉门托县,Condado de Sacramento,Sacramento County,Contea di Sacramento
239944,Republic of India,Republik Indien,Республика Индия,인도 공화국,República da Índia,インド共和国,جمهوری هند,République de l'Inde,印度共和国,República de la India,Indická republika,Repubblica dell'India
239948,Republic of Italy,Republik Italien,Итальянская Республика,이탈리아 공화국,República Italiana,イタリア共和国,جمهوری ایتالیا,République italienne,意大利共和国,República Italiana,Italská republika,Repubblica Italiana
13901,Kreisfreie Stadt Darmstadt,Kreisfreie Stadt Darmstadt,город Дармштадт,다름슈타트,cidade de Darmstadt,ダルムシュタット,شهر دارمشتات,Ville de Darmstadt,达姆施塔特市,ciudad de Darmstadt,město Darmstadt,città di Darmstadt
239056,Hessen,Hessen,Гессен,헤센,Hesse,ヘッセン,هسن,Hesse,黑森州,Hesse,Hesensko,Assia
597,Maryland,Maryland,Мэриленд,메릴랜드,Maryland,メリーランド,مریلند,Maryland,马里兰,Maryland,Maryland,Maryland
604,Mexico City,Mexiko-Stadt,Мехико,멕시코시티,Cidade do México,メキシコシティ,مکزیکو سیتی,Mexico,墨西哥城,Ciudad de México,Mexico City,Città del Messico
4451,Sacramento,Sacramento,Сакраменто,새크라멘토,Sacramento,サクラメント,ساکرامنتو,Sacramento,萨克拉门托,Sacramento,Sacramento,Sacramento
1123,Taipei,Taipeh,Тайбэй,타이베이,Taipei,台北,تایپه,Taipei,台北,Taipei,Tchaj-pej,Taipei
9064,Eastern Manila District,Eastern Manila District,Восточный район Манилы,마닐라 동부 구역,Distrito Leste de Manila,マニラ東部地区,منطقه شرقی مانیل,District Est de Manille,马尼拉东区,Distrito Este de Manila,Východní manilská čtvrť,Distretto orientale di Manila
360,Lombardy,Lombardei,Ломбардия,롬바르디아,Lombardia,ロンバルディア,لومباردی,Lombardie,伦巴第,Lombardía,Lombardie,Lombardia
239979,United Mexican States (Mexico),Vereinigte Mexikanische Staaten (Mexiko),Соединённые Мексиканские Штаты (Мексика),멕시코 합중국,Estados Unidos Mexicanos (México),メキシコ合衆国,ایالات متحده مکزیک,États-Unis du Mexique (Mexique),墨西哥合众国,Estados Unidos Mexicanos (México),Spojené mexické státy (Mexiko),Stati Uniti del Messico (Messico)
363,California,Kalifornien,Калифорния,캘리포니아,Califórnia,カリフォルニア,کالیفرنیا,Californie,加利福尼亚,California,Kalifornie,California
3054,Manila,Manila,Манила,마닐라,Manila,マニラ,مانیل,Manille,马尼拉,Manila,Manila,Manila
8815,Culiacan,Culiacán,Кульякан,쿨리아칸,Culiacán,クリャカン,کولیاکان,Culiacán,库利亚坎,Culiacán,Culiacán,Culiacán
3951,Rome,Rom,Рим,로마,Roma,ローマ,رم,Rome,罗马,Roma,Řím,Roma
102257,Kalyan,Kalyan,Кальян,칼리얀,Kalyan,カリアン,کالیان,Kalyan,卡利扬,Kalyan,Kalyan,Kalyan
37497,Crownsville,Crownsville,Кроунсвилл,크라운스빌,Crownsville,クラウンズビル,کراونزویل,Crownsville,克朗斯维尔,Crownsville,Crownsville,Crownsville

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
idstringThe 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.NoUS 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
languagesstringLanguages spoken in the country, represented as a comma-separated list of BCP 47 / IETF language tagsNoen-US,es-US,haw,fr

I. 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
80,EU,8,IT,ITA,ITA,26,239948,3951,EUR,Euro,€,+39,.it,"it-IT,de-IT,fr-IT,sc,ca,co,sl"
172,NA,7,US,USA,USA,39,240027,240028,USD,US Dollar,$,+1,.us,"en-US,es-US,haw,fr"
41,EU,8,DE,DEU,GER,24,239915,553,EUR,Euro,€,+49,.de,de
202,AS,6,TW,TWN,TPE,38,240053,1123,TWD,New Taiwan Dollar,NT$,+886,.tw,"zh-TW,zh,nan,hak"
133,AS,6,PH,PHL,PHI,40,239993,3054,PHP,Philippine Piso,₱,+63,.ph,"tl,en-PH,fil"
35,AS,6,CN,CHN,CHN,13,239910,266,CNY,Yuan Renminbi,¥,+86,.cn,"zh-CN,yue,wuu,dta,ug,za"
117,NA,7,MX,MEX,MEX,67,239979,604,MXN,Mexican Peso,Mex$,+52,.mx,es-MX
76,AS,6,IN,IND,IND,16,239944,3722,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"

4. File Relationship Diagram

Image

File Format & Encoding

All Standard 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.
  • Lists of values.
  • Spaces that may be auto-quoted by export tools.

MMDB Database Documentation


1. Overview

The MMDB version of our Standard 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 Standard 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

The database includes IP ranges, location, multilingual names, country data, coordinates, and time zone.

  • File Size: 1.36 GB
  • Entries: 41.0M
README.md
README.mdREADME.md

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

  • File Size: 12.11 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 Standard 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-location.mmdb

This file provides city-level geolocation data for IPv4 and IPv6 ranges. Each response includes multilingual details for country, state, district, and city, along with geographic coordinates, time zone, GeoNames ID, and supporting metadata such as codes, currency, and language tags.


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 1 of 31
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).{"en":"North America","de":"Nordamerika","ru":"Северная Америка","ko":"북아메리카","pt":"América do Norte","ja":"北アメリカ","fa":"شمال آمریکا","fr":"Amérique du Nord","zh":"北美洲","es":"América del Norte","cs":"Severní Amerika","it":"America del Nord"}
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).{"en":"United States","de":"Vereinigte Staaten","ru":"Соединенные Штаты","ko":"미국","pt":"Estados Unidos","ja":"アメリカ合衆国","fa":"ایالات متحده آمریکا","fr":"États-Unis","zh":"美国","es":"Estados Unidos","cs":"Spojené státy","it":"Stati Uniti"}
location.country.name_officialobjectThe official name of the country in multiple languages (English, German, Russian, Korean, Portuguese, Japanese, Persian, French, Chinese, Spanish, Czech, Italian).{"en":"United States of America","de":"Vereinigte Staaten von Amerika","ru":"Соединенные Штаты Америки","ko":"미국","pt":"Estados Unidos da América","ja":"アメリカ合衆国","fa":"ایالات متحده آمریکا","fr":"États-Unis d'Amérique","zh":"美利坚合众国","es":"Estados Unidos de América","cs":"Spojené státy americké","it":"Stati Uniti d'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).{"en":"Washington, D.C.","de":"Washington, D.C.","ru":"Вашингтон, округ Колумбия","ko":"워싱턴 D.C.","pt":"Washington, D.C.","ja":"ワシントンD.C.","fa":"واشنگتن دی سی","fr":"Washington, D.C.","zh":"华盛顿特区","es":"Washington D.C.","cs":"Washington, D.C.","it":"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.nameobjectThe name of the currency.{"en":"US 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.en-US,es-US,haw,fr
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).{"en":"California","de":"Kalifornien","ru":"Калифорния","ko":"캘리포니아","pt":"Califórnia","ja":"カリフォルニア","fa":"کالیفرنیا","fr":"Californie","zh":"加利福尼亚","es":"California","cs":"Kalifornie","it":"California"}
location.state.codestringISO 3166-2 subdivision code, including the country prefixUS-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).{"en":"Santa Clara County","de":"Santa Clara County","ru":"Округ Санта-Клара","ko":"산타클라라 카운티","pt":"Condado de Santa Clara","ja":"サンタクララ郡","fa":"شهرستان سانتا کلارا","fr":"Comté de Santa Clara","zh":"圣克拉拉县","es":"Condado de Santa Clara","cs":"Okres Santa Clara","it":"Contea di Santa Clara"}
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).{"en":"Mountain View","de":"Mountain View","ru":"Маунтин-Вью","ko":"마운틴 뷰","pt":"Mountain View","ja":"マウンテンビュー","fa":"مونتین ویو","fr":"Mountain View","zh":"山景","es":"Mountain View","cs":"Mountain View","it":"Mountain View"}
location.coordinatesobjectThe geographical coordinates of the location associated with the IP range.
location.coordinates.latitudestringThe latitude coordinate of the location associated with the IP range.37.3861
location.coordinates.longitudestringThe 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_idstringThe GeoNames ID for the location associated with the IP range.5375480
time_zonestringThe time zone name for the location associated with the IP range.America/Los_Angeles

2. Example Records

Example
{
  "location": {
    "city": {
      "name": {
        "cs": "Kalyan",
        "de": "Kalyan",
        "en": "Kalyan",
        "es": "Kalyan",
        "fa": "کالیان",
        "fr": "Kalyan",
        "it": "Kalyan",
        "ja": "カリアン",
        "ko": "칼리얀",
        "pt": "Kalyan",
        "ru": "Кальян",
        "zh": "卡利扬"
      }
    },
    "coordinates": {
      "latitude": "19.24033",
      "longitude": "73.13054"
    },
    "country": {
      "capital": {
        "cs": "Nové Dillí",
        "de": "Neu-Delhi",
        "en": "New Delhi",
        "es": "Nueva Delhi",
        "fa": "دهلی نو",
        "fr": "New Delhi",
        "it": "Nuova Delhi",
        "ja": "ニューデリー",
        "ko": "뉴델리",
        "pt": "Nova Deli",
        "ru": "Нью-Дели",
        "zh": "新德里"
      },
      "code2": "IN",
      "code3": "IND",
      "code_ioc": "IND",
      "continent": {
        "code": "AS",
        "name": {
          "cs": "Asie",
          "de": "Asien",
          "en": "Asia",
          "es": "Asia",
          "fa": "آسیا",
          "fr": "Asie",
          "it": "Asia",
          "ja": "アジア",
          "ko": "아시아",
          "pt": "Ásia",
          "ru": "Азия",
          "zh": "亚洲"
        }
      },
      "currency": {
        "code": "INR",
        "name": {
          "en": "Indian Rupee"
        },
        "symbol": "₹"
      },
      "metadata": {
        "calling_code": "+91",
        "languages": "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",
        "tld": ".in"
      },
      "name": {
        "cs": "Indie",
        "de": "Indien",
        "en": "India",
        "es": "India",
        "fa": "هند",
        "fr": "Inde",
        "it": "India",
        "ja": "インド",
        "ko": "인도",
        "pt": "Índia",
        "ru": "Индия",
        "zh": "印度"
      },
      "name_official": {
        "cs": "Indická republika",
        "de": "Republik Indien",
        "en": "Republic of India",
        "es": "República de la India",
        "fa": "جمهوری هند",
        "fr": "République de l'Inde",
        "it": "Repubblica dell'India",
        "ja": "インド共和国",
        "ko": "인도 공화국",
        "pt": "República da Índia",
        "ru": "Республика Индия",
        "zh": "印度共和国"
      }
    },
    "district": {
      "name": {
        "cs": "Thane",
        "de": "Thane",
        "en": "Thane",
        "es": "Thane",
        "fa": "تانه",
        "fr": "Thane",
        "it": "Thane",
        "ja": "タネ",
        "ko": "타네",
        "pt": "Thane",
        "ru": "Тхане",
        "zh": "塔内"
      }
    },
    "geoname_id": "1268290",
    "state": {
      "code": "IN-MH",
      "name": {
        "cs": "Maharashtra",
        "de": "Maharashtra",
        "en": "Maharashtra",
        "es": "Maharashtra",
        "fa": "ماهاراشترا",
        "fr": "Maharashtra",
        "it": "Maharashtra",
        "ja": "マハラシュトラ",
        "ko": "마하라슈트라",
        "pt": "Maharashtra",
        "ru": "Махараштра",
        "zh": "马哈拉施特拉邦"
      }
    },
    "zipcode": "421301"
  },
  "time_zone": "Asia/Kolkata"
}

Database Integrity & Authenticity Verification

There are two ways to verify the integrity and authenticity of our databases:


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 Standard 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 Standard 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 Standard 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. 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.