This site uses cookies to personalise content, adverts, and to analyse traffic. I'm ok with that Learn More

Airport API Documentation

This is the documentation to access the Airport API. Very simply, it returns information about a particular Airport.

The API Platform is only available via a REST API, in which you have to let your application grab a URL with parameters and it returns all output in either JSON format. This makes it easy to grab the data using any Programming Language of your choice.

The root URL for the API is:

GET https://aviation.flights/api/airport

Rate Limits

For the longest time it didn't need to be done but as of February 4, 2025 there is now a temporary rate limit of one request per 5 seconds.

Required Header Request

The following header is required on all requests:

x-api-key: The API key provided to you

Required URL Parameters

The following parameters are all required:

Parameter
Description
airport_code
Can either be a ICAO or IATA Airport Code

Output Values for JSON

The following output values are returned after successful query:

Field
Description
airport_id
The Database ID of the Airport
name
The name of the Airport
country
The full Country name the Airport is in.
country_code
The ISO 3166-2 Country Name identifier.
icao_code
The Airport ICAO Code. If neither a ICAO or IATA code exist, but a local code exists it will be in this field as well.
iata_code
The Airport IATA code.
latitude
Part of the Geography coordinates of the location of the Airport.
longitude
Part of the Geography coordinates of the location of the Airport.

Error Codes for JSON

The following are all error codes that can be returned with this function:

Error Message
Description
No API key provided!
No API key has been provided.
API key invalid!
The API key is invalid.

Sample Output

{
    "status": "success",
    "results": [
        {
            "airport": [
                {
                    "airport_id": "4095",
                    "name": "Lester B Pearson Intl",
                    "country": "Canada",
                    "country_code": "CA",
                    "icao_code": "CYYZ",
                    "iata_code": "YYZ",
                    "latitude": "43.677223",
                    "longitude": "-79.630556"
                }
            ]
        }
    ]
}
Chat