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

Airline API Documentation

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

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/airline

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
airline
Can either be a IATA/ICAO Airline Code or the full Airline Name
airline_id
Alternatively, if you know the Airline ID you can just use this parameter

Output Values for JSON

The following output values are returned after successful query:

Field
Description
airline_id
The Database ID of the Airline
name
The name of the Airline
callsign
The callsign the Airline uses on ATC
brand_color
The main brand color code of the Airline in hexadecimal format
country
The full Country name the Airline is in.
country_code
The ISO 3166-2 Country Name identifier.
continent
The Continent the Airline resides in.
icao_code
The Airline ICAO Code.
iata_code
The Airline IATA code.
latitude
Part of the Geography coordinates of the main hub or HQ of the Airline.
longitude
Part of the Geography coordinates of the main hub or HQ of the Airline.
is_cargo
if true then its a Cargo Airline
is_leasing_company
if true then its a easing/Financial/Asset Company
is_government
if true then its a Government/Military Airline
is_business
if true then its a Business/Private Airline
is_charter
if true then its a Charter Airline
is_mro
if true then its a Maintenance (MRO) related Company
is_active
if true then the Airline is currently active
parent_airline_id
If this airline has a parent Airline, the parent Database Airline ID will show here
ceased_operations
If the airline has ceised operations, its estimated date will show up here, in 'Y-m-d' format.
merged_airline_id
If the airline has ceised operations and has merged with a different airline, the merged Database Airline ID will show here

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": [
        {
            "airline": [
                {
                    "airline_id": "14",
                    "name": "Air Canada",
                    "callsign": "AIR CANADA",
                    "brand_color": "000000",
                    "country": "Canada",
                    "country_code": "CA",
                    "continent": "North America",
                    "icao_code": "ACA",
                    "iata_code": "AC",
                    "latitude": "45.465685",
                    "longitude": "-73.745481",
                    "is_cargo": false,
                    "is_leasing_company": false,
                    "is_government": false,
                    "is_active": true,
                    "parent_airline_id": "",
                    "ceased_operations": "0000-00-00",
                    "merged_airline_id": ""
                }
            ]
        }
    ]
}
Chat