UN-LOCODE Codelist

Field	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 country-codes.csv.	[A-Z]{2}
Location	string	3-character location code (letters and digits 2–9). Combined with Country it forms the full 5-character UN/LOCODE.	[A-Z2-9]{3}
Name	string	Official name of the location, may include diacritics.
NameWoDiacritics	string	Name of the location with diacritics replaced by their ASCII equivalents.
Subdivision	string	ISO 3166-2 subdivision code for the location. Defined in subdivision-codes.csv. May be empty.
Status	string	Approval/verification status of the entry. Defined in status-indicators.csv.
Function	string	8-character function classifier string indicating which transport functions the location serves. Each position corresponds to a function code defined in function-classifiers.csv; a digit means the function is present, a dash means absent.	[01-][2-][3-][4-][5-][6-][7-][B-]
Date	string	Edition date in YYMM format (2-digit year + 2-digit month, e.g. 0601 = June 2006, 1407 = July 2014). May be empty for some entries.	[0-9]{4}
IATA	string	IATA airport code, present only when it differs from the UN/LOCODE location code. May be empty.
Coordinates	string	Geographic coordinates in DDMM[N/S] DDDMM[W/E] format (degrees and minutes). May be empty.	[0-9]{4}[NS] [0-9]{5}[WE]
Remarks	string	Free-text remarks or notes about the location entry. May be empty.

Download

About

Main UN/LOCODE codelist. Each row is a location entry identified by a 2-letter country code and a 3-character location code. Rows with an empty Location field are country-name header rows or alias rows and are excluded from this file.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 7.29 MB
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

Field	Type	Description
CountryCode	string	ISO 3166 alpha-2 country code (2 uppercase letters).
CountryName	string	Official English name of the country.

Download

About

Lookup table mapping ISO 3166 alpha-2 country codes to country names, as used in the UN/LOCODE codelist.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 3.94 kB
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

Field	Type	Description
FunctionCode	string	Single-character function code (0–8 or B) used in the Function field of code-list.csv.
FunctionDescription	string	Human-readable description of the transport or logistics function.

Download

About

Lookup table defining the meaning of each position in the Function field of the code-list. Each code corresponds to a transport or logistics function.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 562 B
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

Field	Type	Description
STStatus	string	2-letter status code used in the Status field of code-list.csv.
STDescription	string	Human-readable description of the approval or verification status.

Download

About

Lookup table defining the meaning of the Status field in the code-list. Status codes indicate the approval or verification level of each location entry.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 794 B
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

Field	Type	Description
SUCountry	string	ISO 3166 alpha-2 country code for the subdivision.
SUCode	string	ISO 3166-2 subdivision code (without the country prefix).
SUName	string	Name of the subdivision (state, province, region, etc.).
SUType	string	Type of the administrative subdivision (e.g. Province, State, Region, Emirate). May be empty for some entries.

Download

About

Lookup table of ISO 3166-2 subdivision codes (states, provinces, regions, etc.) referenced by the Subdivision field of the code-list.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 133 kB
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

Field	Type	Description
Country	string	ISO 3166 alpha-2 country code the alias applies to.
Name	string	Alternative country or region name, may include diacritics.
NameWoDiacritics	string	Alternative name with diacritics replaced by ASCII equivalents.

Download

About

Alternative names (aliases) for countries, extracted from UN/LOCODE source files. These are rows in the source data with Change code '=' and no location code.
Last updated: 12 May 2026
Total rows: ...
Format: CSV
File size: 2.73 kB
Source: UN/LOCODE Download page (UNECE)
License: Open Data Commons Public Domain Dedication and License v1.0

About this dataset

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.