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 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
- 18 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
Description
The airport codes may refer to either IATA airport code, a three-letter code which is used in passenger reservation, ticketing and baggage-handling systems, or the ICAO airport code which is a four letter code used by ATC systems and for airports that do not have an IATA airport code (from wikipedia).
Airport codes from around the world. Downloaded from public domain source https://ourairports.com/data/ who compiled this data from multiple different sources. This data is updated nightly.
Data
"data/airport-codes.csv" contains the list of all airport codes, the attributes are identified in datapackage description. Some of the columns contain attributes identifying airport locations, other codes (IATA, local if exist) that are relevant to identification of an airport.
Original source url is https://ourairports.com/data/airports.csv (stored in archive/data.csv)
Note: Currently the scripts is run automatically using Github Actions
Preparation
You will need Python 3.12 or greater to run the script
To update the data run the process script locally:
# To run locally you should do this
# Install using requirements
pip install -r scripts/requirements.txt
python3 scripts/process.py
# Or use make
make
make clean
Several steps will be done to get the final data.
- merge columns "latitude_deg" and "longitude_deg" into "coordinates"
- remove columns: "id", "scheduled_service", "home_link", "wikipedia_link", "keywords"
Automation
Daily updated 'Airport codes' datapackage could be found on the datahub.io:
https://datahub.io/core/airport-codes
License
The source specifies that the data can be used as is without any warranty. Given size and factual nature of the data and its source from a US company would imagine this was public domain and as such have licensed the Data Package under the Public Domain Dedication and License (PDDL).