PIREPs
GET
/api/v1/pireps/nearbyPrivate PilotSearch Nearby
Searches for PIREPs near a geographic point. Returns pilot reports within the specified radius of the given coordinates, useful for checking conditions along a flight route.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/pireps/nearby?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/pireps/nearby?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10"Description
GET /api/v1/pireps/nearby?lat=32.897&lon=-97.038 — default 50 NM radius
GET /api/v1/pireps/nearby?lat=32.897&lon=-97.038&radiusNm=100 — custom radiusReturns paginated results of PirepDto
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 50, max 500) |
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.