Aeronautical Data V1 (1.0.0)

Download OpenAPI specification:Download

Introduction

The Aeronautical Data APIs, part of the Laminar Data Hub provide information on airspaces, aerodromes, routes, designated points and navaids.

V2 of this API is also available with updated Airspaces endpoint and support for microlights.

Cirium is slowly transitioning all v1 APIs to v2 counterparts and will then retire v1. See Aeronautical V2 for details.

Licensing

The Aeronautical Data APIs currently require a contract to use.

Schemas

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

Related articles

Augment maps with aeronautical information - Showcase article on how to add aeronautical information to your apps

Related products

Reference - Reference data for FIRS and ICAO codes

Airports (FlightStats APIs) - Reference data for airports

Route Segments

Route segments by FIR

Retrieves all route segments within a given FIR using AIXM 5.1. Response includes: - Upper and lower limits of the route segment - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Route segments by ID

Retrieves full details for a single route segment using AIXM 5.1.

Note that you will need a Route Segment ID which can be found in the Route Segments by FIR response.

Response includes:

  • Upper and lower limits of the route segment
  • Positional information
  • Availability information
path Parameters
route-segment.id
required
string

ID for the route segment

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Route Segments (USA and Europe Coverage)

Route segments by FIR

Retrieves all route segments within a given FIR using AIXM 5.1. Response includes: - Upper and lower limits of the route segment - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Route segments by ID

Retrieves full details for a single route segment using AIXM 5.1.

Note that you will need a Route Segment ID which can be found in the Route Segments by FIR response.

Response includes:

  • Upper and lower limits of the route segment
  • Positional information
  • Availability information
path Parameters
route-segment.id
required
string

ID for the route segment

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Aerodromes

Aerodromes by ICAO prefix

Retrieves a list of aerodromes for an ICAO designator formatted in AIXM 5.1.

Response includes:

  • Aerodrome name
  • ICAO code (e.g. EGHI)
  • Positional information
path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Aerodrome detail by ICAO code

Retrieves full details for a single aerodrome formatted in AIXM 5.1.

Response includes:

  • Aerodrome name
  • ICAO code (e.g. EGHI)
  • Designator (e.g. SOU)
  • Control type (e.g. Civil or military)
  • Served city
  • Positional information

For a list of possible ICAO prefixes refer to the Reference Data APIs.

path Parameters
aerodrome.icao
required
string

The ICAO designator for an aerodrome e.g. EGHI (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Aerodromes by country

Retrieves full details for aerodromes within the provided ISO 3166 country code in GeoJSON.

path Parameters
country.iso
required
string

The ISO country code to find aerodromes for e.g. FRA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/geo+json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

Aerodromes (Global Coverage)

Aerodromes by ICAO prefix

Retrieves a list of aerodromes for an ICAO designator formatted in AIXM 5.1.

Response includes:

  • Aerodrome name
  • ICAO code (e.g. EGHI)
  • Positional information
path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Aerodrome detail by ICAO code

Retrieves full details for a single aerodrome formatted in AIXM 5.1.

Response includes:

  • Aerodrome name
  • ICAO code (e.g. EGHI)
  • Designator (e.g. SOU)
  • Control type (e.g. Civil or military)
  • Served city
  • Positional information

For a list of possible ICAO prefixes refer to the Reference Data APIs.

path Parameters
aerodrome.icao
required
string

The ICAO designator for an aerodrome e.g. EGHI (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Airspaces

Airspaces by country

Retrieves full details for airspaces within the provided ISO 3166 country code in GeoJSON.

path Parameters
country.iso
required
string

The ISO country code for an airspace e.g. FRA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/geo+json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

Airspaces by FIR

Retrieves a list of airspaces for a FIR. Depending on response content type chosen the format will be different: - application geo json will produce a GeoJSON formatted response - application xml will produce an AIXM 5.1 formatted response Response includes: - Designator (e.g. EGTTOCKC) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
"string"

Airspace detail by ICAO code

Retrieves full details for a single airspace in AIXM 5.1.

Response includes:

  • Designator (e.g. EGTTOCKC)
  • Positional information
path Parameters
airspace.icao
required
string

The ICAO designator for an airspace e.g. EGNVTMA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Airspaces (Europe Coverage)

Airspaces by FIR

Retrieves a list of airspaces for a FIR. Depending on response content type chosen the format will be different: - application geo json will produce a GeoJSON formatted response - application xml will produce an AIXM 5.1 formatted response Response includes: - Designator (e.g. EGTTOCKC) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
"string"

Airspace detail by ICAO code

Retrieves full details for a single airspace in AIXM 5.1.

Response includes:

  • Designator (e.g. EGTTOCKC)
  • Positional information
path Parameters
airspace.icao
required
string

The ICAO designator for an airspace e.g. EGNVTMA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Designated Points

Designated points by FIR

Retrieves a list of all designated points for a given FIR using AIXM 5.1. Response includes: - Designator (e.g. FINMA) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Designated point detail by ICAO code

Retrieves full details for a single designated point using AIXM 5.1. Response includes: - Designator (e.g.FINMA) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

icao
required
string

ICAO code of the Designated Point e.g. OLIVE (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Designated Points (USA and Europe Coverage)

Designated points by FIR

Retrieves a list of all designated points for a given FIR using AIXM 5.1. Response includes: - Designator (e.g. FINMA) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Designated point detail by ICAO code

Retrieves full details for a single designated point using AIXM 5.1. Response includes: - Designator (e.g.FINMA) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

icao
required
string

ICAO code of the Designated Point e.g. OLIVE (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Navaids

NavAids by FIR

Retrieves a list of all navaids for a given FIR using AIXM 5.1. Response includes: - Designator (e.g. BZN) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Navaid detail by ICAO Code

Retrieves full details for a single navaid using AIXM 5.1. Response includes: - Designator (e.g. BZN) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

icao
required
string

ICAO code of the Navaid e.g. BZN (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Navaids (USA and Europe Coverage)

NavAids by FIR

Retrieves a list of all navaids for a given FIR using AIXM 5.1. Response includes: - Designator (e.g. BZN) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Navaid detail by ICAO Code

Retrieves full details for a single navaid using AIXM 5.1. Response includes: - Designator (e.g. BZN) - Positional information For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

icao
required
string

ICAO code of the Navaid e.g. BZN (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Restrictions

Restrictions by country

Retrieves full details for flight restrictions within the provided ISO 3166 country code in GeoJSON. Currently only France (FRA) is supported. If any other country code is requested you will receive a 422 error response.

path Parameters
country.iso
required
string

The ISO country code for an airspace e.g. FRA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/geo+json
{
  • "type": "FeatureCollection",
  • "features": [
    ]
}

Microlight restrictions by country

Retrieves full details for flight restrictions around microlight aerodromes within the provided ISO 3166 country code in GeoJSON. Microlight aerodromes are small, often grass runway, aerodromes that are used mostly for hobbyist flights. They may not appear in our other aerodrome APIs as they are often too minor to appear in many official databases. Important: - This API is NOT AIRAC cycle based and may update on any day - Currently only France (FRA) is supported. If any other country code is requestedyou will receive a 422 error response. - Use of data provided by this API is subject to clause 1.6 of the Laminar Data End User License Agreement.

path Parameters
country.iso
required
string

The ISO country code to filter aerodromes by, e.g. FRA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/geo+json
{
  • "type": "FeatureCollection",
  • "features": [
    ]
}

Runways

Runways by country

Retrieves full details for runways within the provided ISO 3166 country code in GeoJSON.

path Parameters
country.iso
required
string

The ISO country code to find runways for e.g. FRA (Case sensitive)

query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/geo+json
{
  • "type": "",
  • "features": [
    ],
  • "results": {
    }
}
)