Airports API

Download OpenAPI specification:Download

Introduction

The Airports API, part of the FlightStats APIs, delivers important details about an airport including IATA/ICAO codes, location (lat/long), airport name, street address, elevation, UTC time zone offset and more. This data can be delivered as an XML or JSON response in English or Simplified Chinese.

The Airports API also lets you determine which airports are near a specified location (lat/long) within a specified radius. This is very useful for location-based applications (smart phones, tablets, and in-dash navigation systems.

Airports API answer questions such as:

  • What are all the active airports in the world?
  • What are the details for the Airport with this code?

IATA codes are 3 letter codes maintained by the International Air Transport Association and guaranteed to be unique. IATA can reuse airport codes when an old airport closes.

ICAO codes are 4 letter codes maintained by the International Civil Aviation Organization and guaranteed to be unique. The first character in the code corresponds to the country the airport resides in. Not every airport has an ICAO code.

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

Notes: IATA airport codes are also know as location identifier or station codes, and may include railway and bus stations in addition to just airports.

When airports close or the code stops being used for whatever reason, FlightStats marks the airport record as inactive. Inactive airport information may still be valid in case like Historical Flight Status, so both active and inactive airports are returned. If you are only interested in active airports, then use the Active Airports API.

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

Extended options

Besides the normal extended options, the Airport APIs support excludeRailwayStations. When set, the API removes all railway stations from the response.

Licensing

The Airport 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

Aeronautical (Laminar Data Hub) - Aerodrome (airport) reference data for Laminar Data Hub

Airlines - Reference data for Airlines

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 airports

Returns a listing of currently active airports

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" "excludeRailwayStations" "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

Airports response with multiple airports

Loading...

All airports

Returns a listing of all airports, 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" "excludeRailwayStations" "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

Airports response with multiple airports

Loading...

Current by code

Returns the airport that currently has the given code (or null if none). Code type chosen via precedence order.

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

The data format returned in the response

code
required
string
Example: PDX

code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with a single airport

Loading...

By city code

Returns a listing of airports that have had the given city code

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

The data format returned in the response

code
required
string
Example: PDX

City code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with multiple airports

Loading...

By country code

Returns a listing of airports that have had the given country code

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

The data format returned in the response

code
required
string
Example: US

Country code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "languageCode:xx" "excludeRailwayStations"

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

Responses

Response samples

Content type
Example

Airports response with multiple airports

Loading...

By FlightStats code

Returns the airport with the given FlightStats code, a globally unique code across time

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

The data format returned in the response

code
required
string
Example: PDX

FlightStats code, globally unique across time

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with a single airport

Loading...

By IATA code

Returns the airport with 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: PDX

IATA code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with a single airport

Loading...

By ICAO code

Returns the airport with 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: KPDX

ICAO code

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with a single airport

Loading...

Within radius of location

Returns a listing of airports located within a specified radius of the given position

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

The data format returned in the response

longitude
required
string
Example: -122.592901

longitude

latitude
required
string
Example: 45.588995

latitude

radiusMiles
required
string
Example: 10

radiusMiles

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeNewFields" "excludeRailwayStations" "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

Airports response with multiple airports

Loading...
)