Download OpenAPI specification:Download
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.
Click the download button at the top of this document to download the OpenApi spec for this API.
Augment maps with aeronautical information - Showcase article on how to add aeronautical information to your apps
Reference - Reference data for FIRS and ICAO codes
Airports (FlightStats APIs) - Reference data for airports
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.
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) |
user_key required | string User Key Authentication Parameter |
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:
route-segment.id required | string ID for the route segment |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
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:
route-segment.id required | string ID for the route segment |
user_key required | string User Key Authentication Parameter |
Retrieves a list of aerodromes for an ICAO designator formatted in AIXM 5.1.
Response includes:
icao.prefix required | string First letter of the ICAO designator e.g. E (Case sensitive) |
user_key required | string User Key Authentication Parameter |
Retrieves full details for a single aerodrome formatted in AIXM 5.1.
Response includes:
For a list of possible ICAO prefixes refer to the Reference Data APIs.
aerodrome.icao required | string The ICAO designator for an aerodrome e.g. EGHI (Case sensitive) |
user_key required | string User Key Authentication Parameter |
Retrieves full details for aerodromes within the provided ISO 3166 country code in GeoJSON.
country.iso required | string The ISO country code to find aerodromes for e.g. FRA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
{- "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
}
}
Retrieves a list of aerodromes for an ICAO designator formatted in AIXM 5.1.
Response includes:
icao.prefix required | string First letter of the ICAO designator e.g. E (Case sensitive) |
user_key required | string User Key Authentication Parameter |
Retrieves full details for a single aerodrome formatted in AIXM 5.1.
Response includes:
For a list of possible ICAO prefixes refer to the Reference Data APIs.
aerodrome.icao required | string The ICAO designator for an aerodrome e.g. EGHI (Case sensitive) |
user_key required | string User Key Authentication Parameter |
Retrieves full details for airspaces within the provided ISO 3166 country code in GeoJSON.
country.iso required | string The ISO country code for an airspace e.g. FRA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
{- "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
}
}
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.
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) |
user_key required | string User Key Authentication Parameter |
"string"
Retrieves full details for a single airspace in AIXM 5.1.
Response includes:
airspace.icao required | string The ICAO designator for an airspace e.g. EGNVTMA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
"string"
Retrieves full details for a single airspace in AIXM 5.1.
Response includes:
airspace.icao required | string The ICAO designator for an airspace e.g. EGNVTMA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
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.
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) |
user_key required | string User Key Authentication Parameter |
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.
country.iso required | string The ISO country code for an airspace e.g. FRA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
{- "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"
}
}
}
]
}
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.
country.iso required | string The ISO country code to filter aerodromes by, e.g. FRA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
{- "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"
}
}
}
]
}
Retrieves full details for runways within the provided ISO 3166 country code in GeoJSON.
country.iso required | string The ISO country code to find runways for e.g. FRA (Case sensitive) |
user_key required | string User Key Authentication Parameter |
{- "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
}
}