Download OpenAPI specification:Download
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:
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.
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
Returns a listing of currently active airlines
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
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 |
Airlines response with multiple airlines
Returns a listing of all airlines, including those that are not currently active
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
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 |
Airlines response with multiple airlines
Returns the airline with the given FlightStats code, a globally unique code that is consistent across time
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 |
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 |
{- "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"
}
}
Returns a listing of airlines that have had the given IATA code
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
code required | string Example: AS IATA code |
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 |
Airline response with a single airline
Returns a listing of airlines that have had the given ICAO code
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
code required | string Example: ASA ICAO code |
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 |
Airline response with a single airline