Airspace
Controlled and special-use airspace boundaries with classification details.
Endpoints
GET
/api/v1/airspaces/by-classesPrivate Pilot+Get By Classes
Returns paginated results of AirspaceDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| classes | query | string | Comma-separated airspace classes (e.g., B,C,D) |
| cursor | query | string? | Cursor from a previous response to fetch the next page. |
| limit | query | integer | Maximum number of items to return (default 100, max 500). |
Responses
200Returns the paginated airspacesPaginatedResponseOfAirspaceDto
dataAirspaceDto[]The page of results.
globalIdstringnullableArcGIS global unique identifier.
identstringnullableFAA identifier.
icaoIdstringnullableICAO identifier.
namestringnullableAirspace name.
upperDescstringnullableUpper altitude limit description.
upperValnumbernullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure (e.g., FT, FL).
upperCodestringnullableUpper altitude reference code (e.g., MSL, AGL).
lowerDescstringnullableLower altitude limit description.
lowerValnumbernullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure (e.g., FT, FL).
lowerCodestringnullableLower altitude reference code (e.g., MSL, AGL).
typeCodestringnullableAirspace type code (e.g., CLASS_B, CLASS_C).
localTypestringnullableLocal airspace type.
classstringnullableAirspace class (e.g., B, C, D, E).
milCodestringnullableMilitary use code.
commNamestringnullableCommunications facility name.
levelstringnullableLevel designation (e.g., SURFACE, UPPER).
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
wkhrCodestringnullableWorking hours code.
wkhrRmkstringnullableWorking hours remarks.
dststringnullableDaylight saving time indicator.
gmtOffsetstringnullableGMT offset.
contAgentstringnullableControlling agency.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
adhpIdstringnullableAssociated aerodrome identifier.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
paginationPaginationMetadataMetadata for cursor-based pagination.
nextCursorstringnullableCursor value to pass for the next page of results (null if no more pages).
hasMorebooleanWhether more results are available beyond this page.
limitintegerMaximum number of items per page.
400If the classes parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/by-classes?classes=value&limit=25"GET
/api/v1/airspaces/by-citiesPrivate Pilot+Get By City
Returns paginated results of AirspaceDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| cities | query | string | Comma-separated city names |
| cursor | query | string? | Cursor from a previous response to fetch the next page. |
| limit | query | integer | Maximum number of items to return (default 100, max 500). |
Responses
200Returns the paginated airspacesPaginatedResponseOfAirspaceDto
dataAirspaceDto[]The page of results.
globalIdstringnullableArcGIS global unique identifier.
identstringnullableFAA identifier.
icaoIdstringnullableICAO identifier.
namestringnullableAirspace name.
upperDescstringnullableUpper altitude limit description.
upperValnumbernullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure (e.g., FT, FL).
upperCodestringnullableUpper altitude reference code (e.g., MSL, AGL).
lowerDescstringnullableLower altitude limit description.
lowerValnumbernullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure (e.g., FT, FL).
lowerCodestringnullableLower altitude reference code (e.g., MSL, AGL).
typeCodestringnullableAirspace type code (e.g., CLASS_B, CLASS_C).
localTypestringnullableLocal airspace type.
classstringnullableAirspace class (e.g., B, C, D, E).
milCodestringnullableMilitary use code.
commNamestringnullableCommunications facility name.
levelstringnullableLevel designation (e.g., SURFACE, UPPER).
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
wkhrCodestringnullableWorking hours code.
wkhrRmkstringnullableWorking hours remarks.
dststringnullableDaylight saving time indicator.
gmtOffsetstringnullableGMT offset.
contAgentstringnullableControlling agency.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
adhpIdstringnullableAssociated aerodrome identifier.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
paginationPaginationMetadataMetadata for cursor-based pagination.
nextCursorstringnullableCursor value to pass for the next page of results (null if no more pages).
hasMorebooleanWhether more results are available beyond this page.
limitintegerMaximum number of items per page.
400If the cities parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/by-cities?cities=value&limit=25"GET
/api/v1/airspaces/by-statesPrivate Pilot+Get By State
Returns paginated results of AirspaceDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| states | query | string | Comma-separated state codes (e.g., TX,OK) |
| cursor | query | string? | Cursor from a previous response to fetch the next page. |
| limit | query | integer | Maximum number of items to return (default 100, max 500). |
Responses
200Returns the paginated airspacesPaginatedResponseOfAirspaceDto
dataAirspaceDto[]The page of results.
globalIdstringnullableArcGIS global unique identifier.
identstringnullableFAA identifier.
icaoIdstringnullableICAO identifier.
namestringnullableAirspace name.
upperDescstringnullableUpper altitude limit description.
upperValnumbernullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure (e.g., FT, FL).
upperCodestringnullableUpper altitude reference code (e.g., MSL, AGL).
lowerDescstringnullableLower altitude limit description.
lowerValnumbernullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure (e.g., FT, FL).
lowerCodestringnullableLower altitude reference code (e.g., MSL, AGL).
typeCodestringnullableAirspace type code (e.g., CLASS_B, CLASS_C).
localTypestringnullableLocal airspace type.
classstringnullableAirspace class (e.g., B, C, D, E).
milCodestringnullableMilitary use code.
commNamestringnullableCommunications facility name.
levelstringnullableLevel designation (e.g., SURFACE, UPPER).
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
wkhrCodestringnullableWorking hours code.
wkhrRmkstringnullableWorking hours remarks.
dststringnullableDaylight saving time indicator.
gmtOffsetstringnullableGMT offset.
contAgentstringnullableControlling agency.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
adhpIdstringnullableAssociated aerodrome identifier.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
paginationPaginationMetadataMetadata for cursor-based pagination.
nextCursorstringnullableCursor value to pass for the next page of results (null if no more pages).
hasMorebooleanWhether more results are available beyond this page.
limitintegerMaximum number of items per page.
400If the states parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/by-states?states=value&limit=25"GET
/api/v1/airspaces/special-use/by-type-codesPrivate Pilot+Get By Type Code
Returns paginated results of SpecialUseAirspaceDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| typeCodes | query | string | Comma-separated type codes (e.g., R,P,W for restricted, prohibited, warning) |
| cursor | query | string? | Cursor from a previous response to fetch the next page. |
| limit | query | integer | Maximum number of items to return (default 100, max 500). |
Responses
200Returns the paginated special use airspacesPaginatedResponseOfSpecialUseAirspaceDto
dataSpecialUseAirspaceDto[]The page of results.
globalIdstringnullableArcGIS global unique identifier.
namestringnullableAirspace name.
typeCodestringnullableType code (e.g., R for restricted, P for prohibited).
classstringnullableAirspace class.
upperDescstringnullableUpper altitude limit description.
upperValstringnullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure.
upperCodestringnullableUpper altitude reference code.
lowerDescstringnullableLower altitude limit description.
lowerValstringnullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure.
lowerCodestringnullableLower altitude reference code.
levelCodestringnullableLevel code.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
contAgentstringnullableControlling agency.
commNamestringnullableCommunications facility name.
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
timesOfUsestringnullableTimes of use for the airspace.
gmtOffsetstringnullableGMT offset.
dstCodestringnullableDaylight saving time code.
remarksstringnullableAdditional remarks.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
paginationPaginationMetadataMetadata for cursor-based pagination.
nextCursorstringnullableCursor value to pass for the next page of results (null if no more pages).
hasMorebooleanWhether more results are available beyond this page.
limitintegerMaximum number of items per page.
400If the type codes parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/special-use/by-type-codes?typeCodes=value&limit=25"GET
/api/v1/airspaces/by-icao-or-identsPrivate Pilot+Get By Icao Or Ident
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| icaoOrIdents | query | string | Comma-separated ICAO codes or identifiers |
Responses
200Returns the matching airspaces
globalIdstringnullableArcGIS global unique identifier.
identstringnullableFAA identifier.
icaoIdstringnullableICAO identifier.
namestringnullableAirspace name.
upperDescstringnullableUpper altitude limit description.
upperValnumbernullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure (e.g., FT, FL).
upperCodestringnullableUpper altitude reference code (e.g., MSL, AGL).
lowerDescstringnullableLower altitude limit description.
lowerValnumbernullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure (e.g., FT, FL).
lowerCodestringnullableLower altitude reference code (e.g., MSL, AGL).
typeCodestringnullableAirspace type code (e.g., CLASS_B, CLASS_C).
localTypestringnullableLocal airspace type.
classstringnullableAirspace class (e.g., B, C, D, E).
milCodestringnullableMilitary use code.
commNamestringnullableCommunications facility name.
levelstringnullableLevel designation (e.g., SURFACE, UPPER).
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
wkhrCodestringnullableWorking hours code.
wkhrRmkstringnullableWorking hours remarks.
dststringnullableDaylight saving time indicator.
gmtOffsetstringnullableGMT offset.
contAgentstringnullableControlling agency.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
adhpIdstringnullableAssociated aerodrome identifier.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
typestringGeometry type (e.g., Polygon, MultiPolygon).
coordinatesnumber[][][]Coordinate array defining the geometry boundary.
400If the identifiers parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/by-icao-or-idents?icaoOrIdents=value"GET
/api/v1/airspaces/by-global-idsPrivate Pilot+Get By Global Ids
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| globalIds | query | string | Comma-separated global IDs |
Responses
200Returns the matching airspaces
globalIdstringnullableArcGIS global unique identifier.
identstringnullableFAA identifier.
icaoIdstringnullableICAO identifier.
namestringnullableAirspace name.
upperDescstringnullableUpper altitude limit description.
upperValnumbernullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure (e.g., FT, FL).
upperCodestringnullableUpper altitude reference code (e.g., MSL, AGL).
lowerDescstringnullableLower altitude limit description.
lowerValnumbernullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure (e.g., FT, FL).
lowerCodestringnullableLower altitude reference code (e.g., MSL, AGL).
typeCodestringnullableAirspace type code (e.g., CLASS_B, CLASS_C).
localTypestringnullableLocal airspace type.
classstringnullableAirspace class (e.g., B, C, D, E).
milCodestringnullableMilitary use code.
commNamestringnullableCommunications facility name.
levelstringnullableLevel designation (e.g., SURFACE, UPPER).
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
wkhrCodestringnullableWorking hours code.
wkhrRmkstringnullableWorking hours remarks.
dststringnullableDaylight saving time indicator.
gmtOffsetstringnullableGMT offset.
contAgentstringnullableControlling agency.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
adhpIdstringnullableAssociated aerodrome identifier.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
typestringGeometry type (e.g., Polygon, MultiPolygon).
coordinatesnumber[][][]Coordinate array defining the geometry boundary.
400If the global IDs parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/by-global-ids?globalIds=value"GET
/api/v1/airspaces/special-use/by-global-idsPrivate Pilot+Get Special Use By Global Ids
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| globalIds | query | string | Comma-separated global IDs |
Responses
200Returns the matching special use airspaces
globalIdstringnullableArcGIS global unique identifier.
namestringnullableAirspace name.
typeCodestringnullableType code (e.g., R for restricted, P for prohibited).
classstringnullableAirspace class.
upperDescstringnullableUpper altitude limit description.
upperValstringnullableUpper altitude limit value.
upperUomstringnullableUpper altitude unit of measure.
upperCodestringnullableUpper altitude reference code.
lowerDescstringnullableLower altitude limit description.
lowerValstringnullableLower altitude limit value.
lowerUomstringnullableLower altitude unit of measure.
lowerCodestringnullableLower altitude reference code.
levelCodestringnullableLevel code.
citystringnullableCity associated with the airspace.
statestringnullableState associated with the airspace.
countrystringnullableCountry code.
contAgentstringnullableControlling agency.
commNamestringnullableCommunications facility name.
sectorstringnullableSector identifier.
onshorestringnullableWhether the airspace is onshore.
exclusionstringnullableExclusion area indicator.
timesOfUsestringnullableTimes of use for the airspace.
gmtOffsetstringnullableGMT offset.
dstCodestringnullableDaylight saving time code.
remarksstringnullableAdditional remarks.
geometryGeoJsonGeometryGeoJSON geometry representing an airspace boundary.
typestringGeometry type (e.g., Polygon, MultiPolygon).
coordinatesnumber[][][]Coordinate array defining the geometry boundary.
400If the global IDs parameter is emptyApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://preflightapi-apim-service.azure-api.net/api/v1/airspaces/special-use/by-global-ids?globalIds=value"