/api/v1/airspaces/special-use/by-global-idsPrivate PilotGet Special Use By Global Ids
Gets special use airspaces by their global IDs. This endpoint is designed to be used with the
SpecialUseAirspaceGlobalIds returned by the navigation log endpoint (POST /api/v1/navlog/calculate)
to retrieve full details for special use airspaces along a planned route.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/airspaces/special-use/by-global-ids?globalIds=value"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/airspaces/special-use/by-global-ids?globalIds=value"Description
GET /api/v1/airspaces/special-use/by-global-ids?globalIds={guid1},{guid2}Parameters
| Name | In | Type | Description |
|---|---|---|---|
| globalIds | query | string | Comma-separated global IDs (GUIDs from the navlog response's SpecialUseAirspaceGlobalIds field) |
Response Schema
ArcGIS global unique identifier. This is the key used to look up special use airspaces returned by the navigation log endpoint's SpecialUseAirspaceGlobalIds field.
Airspace name.
Type code (e.g., R for restricted, P for prohibited).
Airspace class.
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).
Level code.
City associated with the airspace.
State associated with the airspace.
Country code.
Controlling agency.
Communications facility name.
Sector identifier.
Whether the airspace is onshore.
Exclusion area indicator.
Times of use for the airspace.
GMT offset.
Daylight saving time code.
Additional remarks.
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.