GET/api/v1/airspaces/by-statesPrivate Pilot

Get By State

Gets controlled airspaces filtered by two-letter state code.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/airspaces/by-states?states=value&limit=25"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/airspaces/by-states?states=value&limit=25"

GET /api/v1/airspaces/by-states?states=TX — airspaces in Texas
GET /api/v1/airspaces/by-states?states=TX,OK — airspaces in Texas and Oklahoma

Returns paginated results of AirspaceDto

Name	In	Type	Description
states	query	string	Comma-separated two-letter state codes (e.g., TX or TX,OK)
cursor	query	string?	Opaque cursor value from a previous response's pagination.nextCursor field. Omit or leave null to start from the first page.
limit	query	integer	Maximum number of items to return per page. Minimum 1, maximum 500, default 100.

200Returns the paginated airspacesPaginatedResponseOfAirspaceDto

400If the states 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.