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.
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/airport-codes/
https://datahub.io/core/airport-codes/_r/-/.gitattributes
https://datahub.io/core/airport-codes/_r/-/.gitignore
├ Makefile
https://datahub.io/core/airport-codes/_r/-/Makefile
https://datahub.io/core/airport-codes/_r/-/README.md
https://datahub.io/core/airport-codes/_r/-/UPDATE_SCRIPT_MAINTENANCE_REPORT.md
https://datahub.io/core/airport-codes/_r/-/archive/data.csv
https://datahub.io/core/airport-codes/_r/-/data/airport-codes.csv
https://datahub.io/core/airport-codes/_r/-/data/type-counts.csv
https://datahub.io/core/airport-codes/_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/airport-codes/_r/-/datapackage.json
README.md— documentation
https://datahub.io/core/airport-codes/_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 Views
Data Files
Explore with AIairport-codes
| Field | Type | Format | Description |
|---|---|---|---|
| ident | string | default | OurAirports unique identifier for the airport (e.g. `00A`, `KLAX`, `ZYTX`). |
| type | string | default | Facility type. One of: `small_airport`, `medium_airport`, `large_airport`, `heliport`, `seaplane_base`, `balloonport`. |
| name | string | default | Full name of the airport or airfield. |
| elevation_ft | integer | default | Elevation of the airport above sea level in feet. May be empty when unknown. |
| continent | string | default | Two-letter continent code (e.g. `NA` = North America, `EU` = Europe, `AS` = Asia, `AF` = Africa, `OC` = Oceania, `SA` = South America, `AN` = Antarctica). |
| iso_country | string | default | ISO 3166-1 alpha-2 two-letter country code (e.g. `US`, `CN`, `GB`). |
| iso_region | string | default | ISO 3166-2 region code combining country and subdivision (e.g. `US-CA`, `CN-21`). |
| municipality | string | default | Name of the city or municipality where the airport is located. May be empty. |
| icao_code | string | default | ICAO (International Civil Aviation Organization) 4-letter airport code, used by air traffic control. May be empty for facilities without an ICAO designation. |
| iata_code | string | default | IATA (International Air Transport Association) 3-letter code, used in passenger ticketing and baggage handling. May be empty for facilities without commercial scheduled service. |
| gps_code | string | default | GPS navigation code for the airport; often the same as the ICAO code. May be empty. |
| local_code | string | default | Local country-specific airport code; primarily used for US airports (FAA identifier). May be empty. |
| coordinates | string | default | Geographic coordinates as a `"latitude, longitude"` decimal string, derived from the source `latitude_deg` and `longitude_deg` columns. |
Download
Download CSVAbout
- List of airports and airfields worldwide with their IATA and ICAO codes, location identifiers, facility type, and geographic coordinates. Derived from the OurAirports public domain dataset by merging latitude and longitude into a single coordinates field.
- Last updated
- 9 June 2026
- Total rows
- ...
- Format
- CSV
- File size
- 8.76 MB
- Source
- Our Airports
type-counts
| Field | Type | Format | Description |
|---|---|---|---|
| type | string | default | Facility type (e.g. `Large Airport`, `Small Airport`, `Heliport`). |
| count | integer | default | Number of airports of this type in the dataset. |
Download
Download CSVAbout
- Pre-aggregated count of airports by facility type, matching the type values in airport-codes.csv.
- Last updated
- 4 June 2026
- Total rows
- ...
- Format
- CSV
- File size
- 119 B
- Source
- Our Airports
About this dataset
Update Script Maintenance Report
Date: 2026-03-03
- Ran updater via
make. - Fixed fetch source in
scripts/process.pyfromhttptohttpsand addedraise_for_status(). - Added workflow token write permission in
.github/workflows/actions.yml(permissions: contents: write). - Regenerated data outputs (
archive/data.csv,data/airport-codes.csv,datapackage.json).