Obstacles
GET
/api/v1/obstacles/searchPrivate PilotSearch Nearby
Searches for obstacles near a geographic point.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/obstacles/search?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10&minHeightAgl=25"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/obstacles/search?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10&minHeightAgl=25"Description
GET /api/v1/obstacles/search?lat=32.897&lon=-97.038 — default 5 NM radius
GET /api/v1/obstacles/search?lat=32.897&lon=-97.038&radiusNm=10&minHeightAgl=500 — tall obstacles within 10 NMReturns paginated results of ObstacleDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| lat | query | number | Latitude in decimal degrees (-90 to 90) |
| lon | query | number | Longitude in decimal degrees (-180 to 180) |
| 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 5, must be greater than 0) |
| minHeightAgl | query | integer? | Optional minimum height AGL in feet — only return obstacles at or above this height |
Response Schema
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.