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

Airport Log API Documentation

This is the documentation to access the Airport Log API. It returns user community submitted Airport Conditions. Without the optional parameters it will by default return the latest user submitted observations. User submitted observations marked as private can only be seen by the API key user themselves and are not publicly available.

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-log

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

Optional URL Parameters

The following parameters are all optional:

Parameter
Description
airport_code
Can either be a ICAO or IATA Airport Code
airport_id
If you know the Airport ID from the Airport API you can query the API by that.
limit
The number of items being shown in the format: start,end. (i.e. 0,10 to show the first 10 results). Max results is 50.

Output Values for JSON

The following output values are returned after successful query:

Field
Description
user_airport_condition_id
The ID of the User Airport Condition
airport
A object showing Airports involed within the user submitted observation.
airport_id
the airport id.
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.
sky_cover
The user submitted sky cover
weather
The user submitted weather condition
runway_condition
The user submitted runway condition
comments
Any additional user submitted comments in regards to the observation
date_time
The date & time the observation got posted on Aviation Flights, in 'Y-m-d hh:mm:ss' format.

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_log": [
                {
                    "user_airport_condition_id": "3",
                    "airport": [
                        {
                            "airport_id": "3933",
                            "name": "Lake Simcoe",
                            "country": "Canada",
                            "country_code": "CA",
                            "icao_code": "CYLS",
                            "iata_code": "YLK",
                            "latitude": "44.487778",
                            "longitude": "-79.559444"
                        }
                    ],
                    "sky_cover": "SCT",
                    "weather": "-TSGR",
                    "runway_condition": "WET",
                    "comments": "",
                    "date_time": "2024-08-26 14:30:00"
                }
            ]
        }
    ]
}
Chat