GET/api/v1/obstacles/airport/{icaoCodeOrIdent}Private Pilot

Search Near Airport

Searches for obstacles near an airport. Looks up the airport coordinates, then finds obstacles within the specified radius. Use minHeightAgl to filter out low obstacles.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/obstacles/airport/KJFK?limit=25&radiusNm=10&minHeightAgl=25"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/obstacles/airport/KJFK?limit=25&radiusNm=10&minHeightAgl=25"

Description

Accepts both ICAO codes and FAA identifiers. ICAO/FAA format mismatches are automatically resolved (e.g., KW05 resolves to W05).

GET /api/v1/obstacles/airport/KDFW — default 10 NM radius
GET /api/v1/obstacles/airport/DFW?radiusNm=5&minHeightAgl=200 — towers 200+ ft AGL within 5 NM

Returns paginated results of ObstacleDto

Parameters

Name	In	Type	Description
icaoCodeOrIdent*	path	string	ICAO code or FAA identifier (e.g., KDFW, DFW). Case-insensitive. Automatically resolves ICAO/FAA format mismatches.
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.
radiusNm	query	number	Search radius in nautical miles (default 10, must be greater than 0)
minHeightAgl	query	integer?	Optional minimum height AGL in feet — only return obstacles at or above this height

Response Schema

200Returns the obstacles foundPaginatedResponseOfObstacleDto

400If the radius is invalid or the airport has no coordinates on recordApiErrorResponse

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.

404If the airport is not foundApiErrorResponse