UN-LOCODE Codelist

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files

Dataset Files

Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.

/core/un-locode/

├ .gitignore

https://datahub.io/core/un-locode/_r/-/.gitignore

├ Makefile

https://datahub.io/core/un-locode/_r/-/Makefile

├ README.md

https://datahub.io/core/un-locode/_r/-/README.md

├ UPDATE_SCRIPT_MAINTENANCE_REPORT.md

https://datahub.io/core/un-locode/_r/-/UPDATE_SCRIPT_MAINTENANCE_REPORT.md

├ data/code-list.csv

https://datahub.io/core/un-locode/_r/-/data/code-list.csv

├ data/country-codes.csv

https://datahub.io/core/un-locode/_r/-/data/country-codes.csv

├ data/function-classifiers.csv

https://datahub.io/core/un-locode/_r/-/data/function-classifiers.csv

├ data/status-indicators.csv

https://datahub.io/core/un-locode/_r/-/data/status-indicators.csv

├ data/subdivision-codes.csv

https://datahub.io/core/un-locode/_r/-/data/subdivision-codes.csv

└ datapackage.json

https://datahub.io/core/un-locode/_r/-/datapackage.json

Key Files

Start with these files — they give you everything you need to understand and access the dataset.

datapackage.json— metadata & schema

https://datahub.io/core/un-locode/_r/-/datapackage.json

README.md— documentation

https://datahub.io/core/un-locode/_r/-/README.md

Typical Usage

1. Fetch datapackage.json to inspect schema and resources
2. Download data resources listed in datapackage.json
3. Read README.md for full context

Data Previews

code-list

Loading data...

Schema

name	type	description	pattern
Change	string	+ (newly added); X (to be removed); \| (changed); # (name changed); = (reference entry); ! (US location with duplicate IATA code)
Country	string	ISO 3166 alpha-2 Country Code, defined in countryCodes.csv	[A-Z]{2}
Location	string		[A-Z2-9]{3}
Name	string
NameWoDiacritics	string
Subdivision	string	Defined in subdivisionCodes.csv
Status	string	Defined in statusIndicators.csv
Function	string	Defined in functionClassifiers.csv	[01-][2-][3-][4-][5-][6-][7-][B-]
Date	string	ym	[0-9]{4}
IATA	string	IATA code if different from LOCODE
Coordinates	string	DDMM[N/S] DDDMM[W/E]	[0-9]{4}[NS] [0-9]{5}[WE]
Remarks	string

country-codes

Loading data...

Schema

name	type
CountryCode	string
CountryName	string

function-classifiers

Loading data...

Schema

name	type
FunctionCode	string
FunctionDescription	string

status-indicators

Loading data...

Schema

name	type
STStatus	string
STDescription	string

subdivision-codes

Loading data...

Schema

name	type
SUCountry	string
SUCode	string
SUName	string

Data Files

File	Size	Last modified	Download
code-list	7.41 MB	14 days ago	code-list
country-codes	4.18 kB	14 days ago	country-codes
function-classifiers	300 B	14 days ago	function-classifiers
status-indicators	827 B	14 days ago	status-indicators
subdivision-codes	138 kB	14 days ago	subdivision-codes
alias			alias

Files	Size	Format	Created	Updated	License	Source
6	7.55 MB			21 days ago	Open Data Commons Public Domain Dedication and License v1.0	UNECE

Update Script Maintenance Report

Date: 2026-03-04

Root cause: workflow stability issues from legacy action pattern and narrow dependency pinning.
Fixes made: replaced PR-creation workflow path with commit-if-changed automation, added explicit permissions: contents: write, moved workflow runtime to Python 3.11, and relaxed pandas pin for compatibility.
Validation: reviewed dependency install path and update sequence (make, make clean) with controlled commit scope.
Known blockers: UN/UNECE source format changes can still break parsing and may require script-side adjustments.