Obstacles
GET
/api/v1/obstacles/bboxPrivate PilotGet By Bounding Box
Gets obstacles within a geographic bounding box.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/obstacles/bbox?minLat=40.0&maxLat=41.0&minLon=-74.5&maxLon=-73.0&limit=25&minHeightAgl=25"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/obstacles/bbox?minLat=40.0&maxLat=41.0&minLon=-74.5&maxLon=-73.0&limit=25&minHeightAgl=25"Description
Note: The bounding box must not cross the antimeridian (i.e., minLon must be less than maxLon). Antimeridian-crossing queries are not supported.
GET /api/v1/obstacles/bbox?minLat=32.5&maxLat=33.5&minLon=-97.5&maxLon=-96.5
GET /api/v1/obstacles/bbox?minLat=32.5&maxLat=33.5&minLon=-97.5&maxLon=-96.5&minHeightAgl=500Returns paginated results of ObstacleDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| minLat | query | number | Southwest corner latitude (-90 to 90) |
| maxLat | query | number | Northeast corner latitude (-90 to 90, must be greater than minLat) |
| minLon | query | number | Southwest corner longitude (-180 to 180) |
| maxLon | query | number | Northeast corner longitude (-180 to 180, must be greater than minLon) |
| 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. |
| minHeightAgl | query | integer? | Optional minimum height AGL in feet — only return obstacles at or above this height |
Response Schema
400If coordinates are invalid, minLat >= maxLat, or the box crosses the antimeridianApiErrorResponse
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.