POST/api/v1/briefing/routeCommercial Pilot

Get Route Briefing

Generates a composite weather briefing for a flight route. Accepts a list of waypoints (airport identifiers or lat/lon coordinates) and returns all weather products affecting the route corridor: METARs and TAFs for airports along the route, PIREPs within the corridor, SIGMETs and G-AIRMETs intersecting the route, and active NOTAMs.

Code Examples

curl \
  -X POST \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "waypoints": [],
  "corridorWidthNm": 0
}' \
  "https://api.preflightapi.io/api/v1/briefing/route"

curl \
  -X POST \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "waypoints": [],
  "corridorWidthNm": 0
}' \
  "https://api.preflightapi.io/api/v1/briefing/route"

Description

Each waypoint is either an airport identifier (ICAO or FAA) or a lat/lon coordinate. At least two waypoints are required. The corridor width controls how far from the route centerline to search for PIREPs, airports, and NOTAMs (default 25 NM each side).

Airport-only route

{ "waypoints": [ { "airportIdentifier": "KDFW" }, { "airportIdentifier": "KAUS" } ] }

Mixed route with coordinate waypoints and custom corridor

{ "waypoints": [ { "airportIdentifier": "KDFW" }, { "latitude": 31.5, "longitude": -97.2 }, { "airportIdentifier": "KAUS" } ], "corridorWidthNm": 30 }

Response Contents

Metars — latest METARs for airports within the corridor

Tafs — current TAFs for airports within the corridor

Pireps — pilot reports within the corridor

Sigmets — active SIGMETs whose boundaries intersect the route

GAirmets — active G-AIRMETs whose boundaries intersect the route

Notams — active NOTAMs for airports along the route

Request BodyRouteBriefingRequest

corridorWidthNmnumber

Corridor width in nautical miles on each side of the route centerline. Used for PIREPs, NOTAMs, and airport searches. Default is 25 NM.

Response Schema

200Returns the route weather briefingRouteBriefingResponse

routestring

Route description (e.g., "KDFW -> KAUS").

corridorWidthNmnumber

Corridor width in nautical miles used for the search.

generatedAtdate-time

UTC timestamp when the briefing was generated.

400If the request is invalid (fewer than 2 waypoints, invalid coordinates, etc.)ApiErrorResponse

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 an airport waypoint is not foundApiErrorResponse