/api/v1/airspaces/by-global-idsPrivate PilotGet By Global Ids
Gets controlled airspaces by their global IDs. This endpoint is designed to be used with the
AirspaceGlobalIds returned by the navigation log endpoint (POST /api/v1/navlog/calculate)
to retrieve full details for airspaces along a planned route.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/airspaces/by-global-ids?globalIds=value"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/airspaces/by-global-ids?globalIds=value"Description
GET /api/v1/airspaces/by-global-ids?globalIds={guid1},{guid2}Parameters
| Name | In | Type | Description |
|---|---|---|---|
| globalIds | query | string | Comma-separated global IDs (GUIDs from the navlog response's AirspaceGlobalIds field) |
Response Schema
ArcGIS global unique identifier. This is the key used to look up airspaces returned by the navigation log endpoint's AirspaceGlobalIds field.
FAA identifier.
ICAO identifier.
Airspace name.
Upper altitude limit description.
Upper altitude limit value. Unit determined by UpperUom (FT = feet, FL = flight level). Reference determined by UpperCode (MSL or AGL).
Upper altitude unit of measure (e.g., FT, FL).
Upper altitude reference code (e.g., MSL, AGL).
Lower altitude limit description.
Lower altitude limit value. Unit determined by LowerUom (FT = feet, FL = flight level). Reference determined by LowerCode (MSL or AGL).
Lower altitude unit of measure (e.g., FT, FL).
Lower altitude reference code (e.g., MSL, AGL).
Airspace type code (e.g., CLASS_B, CLASS_C).
Local airspace type.
Airspace class (e.g., B, C, D, E).
Military use code.
Communications facility name.
Level designation (e.g., SURFACE, UPPER).
Sector identifier.
Whether the airspace is onshore.
Exclusion area indicator.
Working hours code.
Working hours remarks.
Daylight saving time indicator.
GMT offset.
Controlling agency.
City associated with the airspace.
State associated with the airspace.
Country code.
Associated aerodrome identifier.
Machine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
Human-readable error message suitable for display.
Additional error details (only included in development environment).
Name of the external service that failed (only included for 503 errors).
Field-level validation errors (only for validation failures).
UTC timestamp when the error occurred.
Correlation ID for tracing the request.
Request path that generated the error.