Obstacles

Provides access to obstacle data from the FAA Digital Obstacle File (DOF). Obstacles include towers, buildings, smokestacks, and other structures that may affect flight safety. Each obstacle has an OAS (Obstacle Assessment Surface) number as its unique identifier. OAS numbers are returned by the navigation log endpoint for obstacles near a planned route — use the by-oas-numbers endpoint to retrieve full details for those obstacles.

FAA Digital Obstacle File (DOF) with 625,000+ charted obstacles including towers, cranes, antennas, and other structures. Supports search, filtering, and spatial nearby queries.

FAA Digital Obstacle File

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.

GET/api/v1/obstacles/searchPrivate Pilot

Search Nearby

Searches for obstacles near a geographic point.

GET/api/v1/obstacles/state/{stateCode}Private Pilot

Get By State

Gets obstacles in a specific state.

GET/api/v1/obstacles/{oasNumber}Private Pilot

Get By Oas Number

Gets a single obstacle by its OAS (Obstacle Assessment Surface) number.

POST/api/v1/obstacles/by-oas-numbersPrivate Pilot

Get By Oas Numbers

Gets multiple obstacles by their OAS numbers. This endpoint is designed to be used with the ObstacleOasNumbers returned by the navigation log endpoint (POST /api/v1/navlog/calculate) to retrieve full details for obstacles near a planned route.

GET/api/v1/obstacles/bboxPrivate Pilot

Get By Bounding Box

Gets obstacles within a geographic bounding box.