API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
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.
Start with these files — they give you everything you need to understand and access the dataset.
- 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 Files
Explore with AIcode-list
| 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
Download CSVAbout
- 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
- 16 April 2026
- Total rows
- ...
- Format
- CSV
- File size
- 7.41 MB
country-codes
| Field | Type | Description |
|---|---|---|
| CountryCode | string | ISO 3166 alpha-2 country code (2 uppercase letters). |
| CountryName | string | Official English name of the country. |
Download
Download CSVAbout
- Lookup table mapping ISO 3166 alpha-2 country codes to country names, as used in the UN/LOCODE codelist.
- Last updated
- 16 April 2026
- Total rows
- ...
- Format
- CSV
- File size
- 4.18 kB
function-classifiers
| 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
Download CSVAbout
- 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
- 16 April 2026
- Total rows
- ...
- Format
- CSV
- File size
- 300 B
status-indicators
| 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
Download CSVAbout
- 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
- 16 April 2026
- Total rows
- ...
- Format
- CSV
- File size
- 827 B
subdivision-codes
| 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
Download CSVAbout
- Lookup table of ISO 3166-2 subdivision codes (states, provinces, regions, etc.) referenced by the Subdivision field of the code-list.
- Last updated
- 16 April 2026
- Total rows
- ...
- Format
- CSV
- File size
- 138 kB
About this dataset
The United Nations Code for Trade and Transport Locations is a code list maintained by UNECE, United Nations agency, to facilitate trade.
Data
Data comes from the UNECE UN/LOCODE Download page, released at least once a year.
Preparation
As the original release files have encoding problems, we need to process both the mdb and the csv release. To build the dataset we use the csv version of the current edition.
Tools needed: MDBTools and CSVKit.
Download the current edition from UNECE and put it into the root directory.
Then execute bash scripts/prepare_edition_mdb.sh loc{ed}mdb.zip, where {ed} identify the release.
To integrate the data from the csv then run the python file
Prerequisites:
pip install pandas titlecase
Run:
python scripts/integrate.py loc232csv.zip
The provided prepare.py file would work alone when the original csv file will be fixed upstream.
License
All data is licensed under the ODC Public Domain Dedication and Licence (PDDL).