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

Flight API Documentation

This is the documentation to access the Aviation Flights Group Aircraft/Flight Data API, including activity submitted via the Community Log.

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 API will always only show 100 results at a time.

Your API key is:

The root URLs for the API is:

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

The best way to play around with the API is to use the Detailed Search form, located in the top menu when in one of the Aircraft Manufacturers sites. You can fill out any parameter as you wish and use "API" as the output format.

Certain Flight Activity will not show up in the API. This includes any Flight Activity that contains "Added to Database", "Spotted" and any Flights initially picked up by a Flight Tracker where Commercial use is not permitted.

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. This is ignored when previewing the API through the search.

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
family
Aircraft Family
msn
The MSN Construction Number
line_number
The Line Number
registration
The registration of a Aircraft
aircraft_type
The Aircraft Type
airline
Name of an Airline
flight_activity
Flight Activity
callsign
The Callsign in which the Flight Activity is associated with.
hex
The Hex code in which the Flight Activity is associated with.
start_date
The start date of Flight activities in 'Y-m-d' format.
end_date
The end date of Flight activities in 'Y-m-d' format.
flight_special_notes
Any special notes regarding the flight
fal
The airport iata code of the final assembly line airport
airport
The airport iata code of any airport
undelivered
if set to true it will only return undelivered aircraft
delivered
if set to true it will only return delivered aircraft
exclude_transport_charter
if set to true it will exclude transport and charter flights
show_only_community_log NEW
if set to true this will only include Flight Activity submitted via the Community Log
exclude_community_log NEW
if set to true this will exclude Flight Activity submitted via the Community Log
acj
if set to true it will only include Private Jets
flight_special_notes_only
if set to true it will only include flights that have special notes associated with them
p2f
if set to true it will only include flights that are associated with Passenger to Freighter (P2F)
special_livery
if set to true it will only include flight activity that have special c/s in the description.
limit
pagination of the results in the format of 0,100. To go to page 2 of the result use 100,200 etc. Only returns 100 returns per request.

Output Values for JSON

The following output values are returned after successful query:

Field
Description

Aircraft Information

msn
The MSN Construction Number
line_number
The Line Number
aircraft_family
The Aircraft Family
aircraft_type
The Aircraft Type
engine_type
The engine type being used
test_registration
The Test Registration in which the Aircraft is associated with.
delivery_registration
The Delivery Registration in which the Aircraft is associated with.
site_ident
Identifies which site it is on Aviation Flights. (i.e. aib is Airbus, boe is Boeing etc)
production_site
The airport details where the aircraft has been assembled
is_delivered
Can be either true or false
is_test_aircraft
Can be either true or false
is_scrapped
Can be either true or false
is_written_off
Can be either true or false
aircraft_url
The full URL to the Aircraft Profile.
aircraft_first_seen
The Date & Time from the Flight Activity in which the Aircraft was first logged on the site, in Unix Time Stamp format.

Flight Information

aircraft_type
The Aircraft type, mostly used for post delivery flight activity.
airline
The Airline in which the Flight Activity is associated with.
registration
The Registration in which the Flight Activity is associated with.
flight_activity
The description of the Flight Activity. This usually contains Airport codes in IATA format.
callsign
The Callsign in which the Flight Activity is associated with.
hex
The Hex code in which the Flight Activity is associated with.
date_time
The textual representaton of the Flight Activity's Date as well as the Flights start and ending time.
flight_time
The calculated Flight time based on the date & times from the date_time field.
special_notes
Any special notes about this Flight Activity.
is_community_log NEW
Formerly is_post_delivery, it can be either true or false to show this is submitted via the Community Log
first_seen
The Date & Time in which the Flight Activity was first seen, in Unix Time Stamp 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": [
        {
            "aircraft_information": [
                {
                    "msn": "62536",
                    "line_number": "7763",
                    "aircraft_type": "737-8 Max",
                    "engine_type": "",
                    "test_registration": "N8743K",
                    "delivery_registration": "N8743K",
                    "is_delivered": false,
                    "is_scrapped": false,
                    "is_written_off": false,
                    "is_test_aircraft": false,
                    "aircraft_url": "https://boefamily.flights/737/62536",
                    "aircraft_first_seen": "1729346940"
                }
            ],
            "flight_information": [
                {
                    "aircraft_type": "737-8 Max",
                    "airline": "Southwest Airlines",
                    "registration": "N8743K",
                    "flight_activity": "Test Flight BFI-BFI",
                    "airports_involved": [
                        {
                            "title": "Seattle, United States (KBFI/BFI)",
                            "icao_code": "KBFI",
                            "iata_code": "BFI",
                            "latitude": "47.53",
                            "longitude": "-122.301947"
                        }
                    ],
                    "callsign": "BOE049",
                    "hex": "AC07FD",
                    "date_time": "Jan 16 2021 16:55-19:01 UTC",
                    "flight_time": "3h 6m",
                    "special_notes": "",
                    "is_community_log": false,
                    "first_seen": "2021-01-16 16:55:00"
                }
            ]
        }
    ]
}
By becoming a Aviation Flights Premium Subscriber you can get exclusive content. Thank you very much to those that have already supported.
Chat