Airlines API

Download OpenAPI specification:Download

URL: https://helpdesk.cirium.com/ Terms of Service

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

SOAP (deprecated) - WSDL XSD
REST - WADL XSD

Extended fields

SOAP (deprecated) - WSDL+XSD
REST - WADL XSD JSON

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

Authorizations:

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

200
400
403
404
5XX

Content type

Example

Airlines response with multiple airlines

Loading...

All airlines

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

Authorizations:

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

200
400
403
404
5XX

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

Authorizations:

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

200
400
403
404
5XX

Content type

{"error": {"httpStatusCode": 400,
"errorId": "4d1c06b9-f999-4fd6-81fd-9a7d1cd5768f",
"errorMessage": "Invalid value for carrier: AAAA|Invalid value for date: 1969-02-02 - The date specified is not within the expected range. Earliest allowed date '2021-08-23'",
"errorCode": "BAD_REQUEST"
},
"airlines": [{"fs": "AS",
"iata": "AS",
"icao": "ASA",
"name": "Alaska Airlines",
"phoneNumber": "1-800-433-7300",
"active": true,
"dateFrom": "string",
"dateTo": "string",
"category": "string"
}
],
"airline": {"fs": "AS",
"iata": "AS",
"icao": "ASA",
"name": "Alaska Airlines",
"phoneNumber": "1-800-433-7300",
"active": true,
"dateFrom": "string",
"dateTo": "string",
"category": "string"
}
}

By IATA code

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

Authorizations:

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

200
400
403
404
5XX

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

Authorizations:

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

200
400
403
404
5XX

Content type

Example

Airline response with a single airline

Loading...