Airspace
GET/api/v1/airspaces/by-icao-or-identsPrivate Pilot

Get By Icao Or Ident

Gets controlled airspaces associated with specific airports by ICAO code or FAA identifier.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/airspaces/by-icao-or-idents?icaoOrIdents=value"

Description

Returns all controlled airspace boundaries (Class B, C, D) associated with the given airport identifiers. Each result includes the airspace classification, altitude limits, and boundary geometry. Pass multiple identifiers as a comma-separated list to retrieve airspaces for several airports in a single request.

Parameters

NameInTypeDescription
icaoOrIdentsquerystringComma-separated ICAO codes or FAA identifiers (e.g., KDFW,KORD,KJFK)

Response Schema

200Returns the matching airspaces
globalIdstringnullable

ArcGIS global unique identifier. This is the key used to look up airspaces returned by the navigation log endpoint's AirspaceGlobalIds field.

identstringnullable

FAA identifier.

icaoIdstringnullable

ICAO identifier.

namestringnullable

Airspace name.

upperDescstringnullable

Upper altitude limit description.

upperValnumbernullable

Upper altitude limit value. Unit determined by UpperUom (FT = feet, FL = flight level). Reference determined by UpperCode (MSL or AGL).

upperUomstringnullable

Upper altitude unit of measure (e.g., FT, FL).

upperCodestringnullable

Upper altitude reference code (e.g., MSL, AGL).

lowerDescstringnullable

Lower altitude limit description.

lowerValnumbernullable

Lower altitude limit value. Unit determined by LowerUom (FT = feet, FL = flight level). Reference determined by LowerCode (MSL or AGL).

lowerUomstringnullable

Lower altitude unit of measure (e.g., FT, FL).

lowerCodestringnullable

Lower altitude reference code (e.g., MSL, AGL).

typeCodestringnullable

Airspace type code (e.g., CLASS_B, CLASS_C).

localTypestringnullable

Local airspace type.

classstringnullable

Airspace class (e.g., B, C, D, E).

milCodestringnullable

Military use code.

commNamestringnullable

Communications facility name.

levelstringnullable

Level designation (e.g., SURFACE, UPPER).

sectorstringnullable

Sector identifier.

onshorestringnullable

Whether the airspace is onshore.

exclusionstringnullable

Exclusion area indicator.

wkhrCodestringnullable

Working hours code.

wkhrRmkstringnullable

Working hours remarks.

dststringnullable

Daylight saving time indicator.

gmtOffsetstringnullable

GMT offset.

contAgentstringnullable

Controlling agency.

citystringnullable

City associated with the airspace.

statestringnullable

State associated with the airspace.

countrystringnullable

Country code.

adhpIdstringnullable

Associated aerodrome identifier.

400The identifiers parameter is emptyApiErrorResponse
codestring

Machine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").

messagestring

Human-readable error message suitable for display.

detailsstringnullable

Additional error details (only included in development environment).

servicestringnullable

Name of the external service that failed (only included for 503 errors).

validationErrorsRecord<string, string[]>nullable

Field-level validation errors (only for validation failures).

timestampstring

UTC timestamp when the error occurred.

traceIdstringnullable

Correlation ID for tracing the request.

pathstringnullable

Request path that generated the error.

Search Documentation

Search docs, endpoints, and schemas