The airline object contains the unique codes and name that identify a unique airline or carrier

Boolean value indicating if the airline is currently active

Ignore. These are currently not returned.

The Cirium code for the carrier, globally unique across time

The primary customer service phone number for the carrier

The response body includes the following:
- InterpretedRequest - The API returns the information you requested, plus any interpretation of your request (for example, it will show you the FlightStats code for an airline that it is using and that may be different than the IATA or ICAO code provided)
- APIResponseError - If there is an error, the response includes this error object describing the problem
- airline - If the result is a single airline, the API returns the airline in this element
- airlines - If the result includes more than one airline, the API returns an array of Airline elements


response

In the default case, when an error occurs the API returns a 200 status code and this structure contains information about the error. Not returned if specifying _extendedOptions=useHTTPErrors_, in which case the API returns the HTTP error code and _text/plain_ body containing the same information as in the structure.

This is a unique identifier for the error used internally at Cirium. Include this string in helpdesk requests to help us troubleshoot issues.

This contains detail about the error. If there are multiple errors in the request, the string may have multiple items separated by a '|' character.

This is the standard HTTP code (400, 401, 404, etc...)

appId

Authentication key of the application making the request

appKey

Cirium Help Desk

## Introduction
The Airlines API, part of the [FlightStats APIs](/apis/flightstats-apis/overview), 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](/apis/flightstats-apis/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](https://api.flightstats.com/flex/airlines/docs/v1/lts/soap/airlinesService.wsdl) [XSD](https://api.flightstats.com/flex/airlines/docs/v1/lts/soap/airlinesService.xsd)
* REST - [WADL](https://api.flightstats.com/flex/airlines/docs/v1/lts/rest/airlinesService.wadl) [XSD](https://api.flightstats.com/flex/airlines/docs/v1/lts/rest/airlinesService.xsd)

Extended fields
* SOAP (deprecated) - [WSDL+XSD](https://api.flightstats.com/flex/airlines/soap/v1/airlinesService?wsdl)
* REST - [WADL](https://api.flightstats.com/flex/airlines/rest/v1/schema/wadl) [XSD](https://api.flightstats.com/flex/airlines/rest/v1/schema/xsd) [JSON](https://api.flightstats.com/flex/airlines/rest/v1/schema/json)

## Similar APIs 
[Airports](/apis/flightstats-apis/airports) - Reference data for Airports

[Equipment](/apis/flightstats-apis/equipment) - Reference data for Equipement


Airlines API

Returns a listing of currently active airlines


format

[Extended options](/apis/flightstats-apis/get-started) for modifying standard API behavior to fit special use cases

extendedOptions

Client request error. Consult error response for specifics.

Authorization failure. Invalid 'appId', 'appKey', or rate limit violation.

Requested item could not be found, or the endpoint does not exist.

API application error. If error is consistent, please contact Cirium Support.

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


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


FlightStats code, globally unique across time

code

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


A list of airlines that have had the requested code.

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


A list of airlines that have had the requested ICAO code.