/airports

Airports API: get basic info by IATA or ICAO code

Primary LanguageJavaScript

airports

Simple API for getting basic airports info, like city and country. Mostly for learning and demo purposes.

TL;DR

Check out http://airports-api.marinin.xyz. API is provided without any guarantees of anything, but I suppose I'll keep it running while it doesn't get too messy. Please, do not abuse this instance.

At the moment there is no authentication or rate limiting, and I want to keep it that way.

Background (a little)

There are two most common types of airport identifier: IATA code and ICAO code. IATA code is the three-letter one on the luggage, like DME or JFK. ICAO code consists of 4 characters, like UUDD or KFJK.

This project uses data from @mwgg/Airports which is licensed under MIT license.

Endpoints

/iata
Get all available IATA codes in the dataset.
/iata/[IATA]
Get airport description or {"error": "Airport Not Found"}
/icao
Get all available ICAO codes in the dataset
/icao/[ICAO]
Get airport description or {"error": "Airport Not Found"}
/[COUNTRY]
Get cities in the with airports counts.
/[COUNTRY]/[CITY]
Get [ICAO] codes of airports in the city. Country is added to avoid ambiguities like Paris, US and PARIS, FR.
/
Get links to /iata, /icao, and available countries.

License

Dataset is available at @mwgg/Airports and licensed under MIT license.

This code is licensed under MIT license as well.

Tim Marinin, 2017.