Aeronautical Data V1 (1.0.0)

Download OpenAPI specification:Download

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

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

200
400
401
403

Content type

application/geo+json

{"type": "FeatureCollection",
"features": [{"id": "116128c3-2fbd-4edc-895f-85c21ceae545",
"type": "Feature",
"geometry": {"type": "Point",
"coordinates": [150.99795471191405,
-33.71134487915039
]
},
"properties": {"designator": "EGKK",
"designatorIata": "LGW",
"locationIndicatorIcao": "EGKK",
"name": "LONDON/GATWICK",
"type": "AD",
"controlType": "CIVIL",
"elevation": {"uom": "FT",
"value": "203",
"reference": "MSL"
}
}
}
],
"results": {"publishTime": "2018-07-30T11:30:31.025Z",
"status": "ok",
"total": 1
}
}

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

200
400
401
403

Content type

application/geo+json

{"type": "FeatureCollection",
"features": [{"id": "116128c3-2fbd-4edc-895f-85c21ceae545",
"type": "Feature",
"geometry": {"type": "Polygon",
"lowerLimit": {"uom": "FLIGHT_LEVEL",
"value": "50",
"reference": "AMSL"
},
"upperLimit": {"uom": "FEET",
"value": "15000",
"reference": "AGL"
},
"coordinates": [[[-3.6167,
56.2833
],
[-10,
57.5
],
[-10,
54.5667
],
[-8.25,
55.3333
],
[-4.52,
53.7714
],
[-4.3642,
53.9053
],
[-3.8256,
53.9603
],
[-3.5,
54.8167
],
[-3.6167,
56.2833
]
]
]
},
"properties": {"name": "MANCHESTER CTA 1",
"designator": "EGTT",
"type": "AMA",
"localType": "Military Operations Area",
"controlType": "CIVIL",
"classification": "A"
}
}
],
"results": {"publishTime": "2018-07-30T11:30:31.025Z",
"status": "ok",
"total": 1
}
}

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

200

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

200

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

200
400
401
403
422

Content type

application/geo+json

{"type": "FeatureCollection",
"features": [{"id": "116128c3-2fbd-4edc-895f-85c21ceae545",
"type": "Feature",
"geometry": {"type": "Polygon",
"coordinates": [[[-3.6167,
56.2833
],
[-10,
57.5
],
[-10,
54.5667
],
[-8.25,
55.3333
],
[-4.52,
53.7714
],
[-4.3642,
53.9053
],
[-3.8256,
53.9603
],
[-3.5,
54.8167
],
[-3.6167,
56.2833
]
]
]
},
"properties": {"designator": "09R/27L",
"type": "runway",
"aerodromeDesignator": "EGKK",
"aerodromeName": "LONDON/GATWICK",
"aerodromeControlType": "CIVIL",
"aerodromeType": "AD",
"aerodromeControlled": true,
"lowerLimit": {"uom": "FLIGHT_LEVEL",
"value": "50",
"reference": "AMSL"
},
"upperLimit": {"uom": "FEET",
"value": "15000",
"reference": "AGL"
}
}
}
]
}

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

200
400
401
403
422

Content type

application/geo+json

{"type": "FeatureCollection",
"features": [{"id": "116128c3-2fbd-4edc-895f-85c21ceae545",
"type": "Feature",
"geometry": {"type": "Polygon",
"coordinates": [[[-3.6167,
56.2833
],
[-10,
57.5
],
[-10,
54.5667
],
[-8.25,
55.3333
],
[-4.52,
53.7714
],
[-4.3642,
53.9053
],
[-3.8256,
53.9603
],
[-3.5,
54.8167
],
[-3.6167,
56.2833
]
]
]
},
"properties": {"designator": "09R/27L",
"type": "runway",
"aerodromeDesignator": "EGKK",
"aerodromeName": "LONDON/GATWICK",
"aerodromeControlType": "CIVIL",
"aerodromeType": "AD",
"aerodromeControlled": true,
"lowerLimit": {"uom": "FLIGHT_LEVEL",
"value": "50",
"reference": "AMSL"
},
"upperLimit": {"uom": "FEET",
"value": "15000",
"reference": "AGL"
}
}
}
]
}

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

200
400
401
403

Content type

application/geo+json

{"type": "",
"features": [{"id": "",
"type": "",
"geometry": {"type": "LineString",
"coordinates": [[0
]
]
},
"properties": {"aerodromeDesignator": "LFPG",
"designator": "09L/27R",
"length": 8858,
"width": 197,
"eastingBearing": {"value": 84,
"type": "magnetic"
},
"westingBearing": {"value": 264,
"type": "magnetic"
}
}
}
],
"results": {"publishTime": "2018-07-30T11:30:31.025Z",
"status": "ok",
"total": 1
}
}

Aeronautical Data V1 (1.0.0)

Introduction

Licensing

Schemas

Related articles

Related products

Route Segments

Route segments by FIR

path Parameters

query Parameters

Responses

Route segments by ID

path Parameters

query Parameters

Responses

Route Segments (USA and Europe Coverage)

Route segments by FIR

path Parameters

query Parameters

Responses

Route segments by ID

path Parameters

query Parameters

Responses

Aerodromes

Aerodromes by ICAO prefix

path Parameters

query Parameters

Responses

Aerodrome detail by ICAO code

path Parameters

query Parameters

Responses

Aerodromes by country

path Parameters

query Parameters

Responses

Response samples

Aerodromes (Global Coverage)

Aerodromes by ICAO prefix

path Parameters

query Parameters

Responses

Aerodrome detail by ICAO code

path Parameters

query Parameters

Responses

Airspaces

Airspaces by country

path Parameters

query Parameters

Responses

Response samples

Airspaces by FIR

path Parameters

query Parameters

Responses

Response samples

Airspace detail by ICAO code

path Parameters

query Parameters

Responses

Airspaces (Europe Coverage)

Airspaces by FIR

path Parameters

query Parameters

Responses

Response samples

Airspace detail by ICAO code

path Parameters

query Parameters

Responses

Designated Points

Designated points by FIR

path Parameters

query Parameters

Responses

Designated point detail by ICAO code

path Parameters

query Parameters