epranka / airports-db

Public airports database API service based on GitHub

✈️ Public airports database

This project is deprecated and unmaintainable due to the GitHub limitations. Please use the https://airportdb.io for free airport database API

GitHub based API service

This is a JSON database of airports which contains about 56k airports with their runways, communication frequencies, navaids, countries, and regions information. The database is not 100% accurate because can have older data, so do not use it for a real flight or very sensitive applications. But it works well to get basic information about the airport.

How to use it? 🤔

John F Kennedy International Airport KJFK

The main idea of this repository is to get the JSON data about the airport by using its ICAO code. Every airport has its own JSON file placed in icao directory.

So, to get the information about the airport use the following url:

https://raw.githubusercontent.com/epranka/airports-db/master/icao/<enter your ICAO>.json

ICAO code must be in uppercase

For example

  $ curl https://raw.githubusercontent.com/epranka/airports-db/master/icao/KJFK.json

If airport is not found, the 404 status code is returned.

Have ideas on how to improve it? Feel free to share it on the GitHub Issues.

Data is based on ourairports.com database. You can download the raw CSV files from raw directory. The repository will be updated automatically every day at 7:00 UTC. You can get the latest CSV files here: https://ourairports.com/data/