Airlines API

Download OpenAPI specification:Download

Introduction

The Airlines API, part of the FlightStats APIs, delivers important details about an airline including IATA/ICAO codes, airline name, and active/inactive status.

Airlines API answer questions such as:

  • What are all active airlines right now?
  • What are all active airlines as of a specific date?
  • What are the airline details for a specific IATA or ICAO code?

IATA codes are 2 letter codes maintained by the International Air Transport Association. IATA can reuse airline codes 6 months after an airline has delisted. IATA also issues controlled duplicates for airlines that are guaranteed to not operate in the same region.

ICAO codes are 3 letter codes maintained by the International Civil Aviation Organization and guaranteed to be unique.

FlightStats code is the 2-3 letter codes assigned to the airline in FlightStats systems and are unique.

When airlines go out of business or the code stops being used for whatever reason, FlightStats marks the airline record as inactive. Inactive airline information may still be valid in case like Historical Flight Status, so both active and inactive airlines are returned. If you are only interested in active airlines, then use the Active Airlines API.

IATA codes are also assigned to Railway, Ferry and Bus companies. To filter the result set to just airlines, use the category attribute to remove the non-airline elements.

Reference data is typically downloaded and cached in customer systems. Cirium recommends our customers refresh their caches of reference data at least weekly.

Licensing

The Equipment APIs are standard APIs and included in our Commercial and Contract plans.

A breakdown of the available plans is available on Get evaluation account

Schemas

Click the download button at the top of this document to download the OpenApi spec for this API. Other schemas:

Long term support

Extended fields

Related products

Aircraft - The Aircraft API contains information about an Airline's fleet and also information about the airlines as well

Airports - Reference data for Airports

Equipment - Reference data for Equipement

Authentication

appIdQueryParam

ID of the application making the request

Security Scheme Type API Key
Query parameter name: appId

appKeyQueryParam

Authentication key of the application making the request

Security Scheme Type API Key
Query parameter name: appKey

appIdHeader

ID of the application making the request

Security Scheme Type API Key
Header parameter name: appId

appKeyHeader

Authentication key of the application making the request

Security Scheme Type API Key
Header parameter name: appKey

Active airlines

Returns a listing of currently active airlines

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
Example

Airlines response with multiple airlines

Loading...

All airlines

Returns a listing of all airlines, including those that are not currently active

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
Example

Airlines response with multiple airlines

Loading...

By FlightStats code

Returns the airline with the given FlightStats code, a globally unique code that is consistent across time

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

code
required
string
Example: AS

FlightStats code, globally unique across time

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
{
  • "error": {
    },
  • "airlines": [
    ],
  • "airline": {
    }
}

By IATA code

Returns a listing of airlines that have had the given IATA code

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

code
required
string
Example: AS

IATA code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
Example

Airline response with a single airline

Loading...

By ICAO code

Returns a listing of airlines that have had the given ICAO code

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

code
required
string
Example: ASA

ICAO code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
Example

Airline response with a single airline

Loading...
)