GET/api/v1/navlog/winds-aloft/{forecast}Commercial Pilot

Get Winds Aloft Data

Retrieves winds aloft (FB) forecast data for all reporting sites across the US.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/navlog/winds-aloft/06"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/navlog/winds-aloft/06"

Description

Returns wind direction, wind speed, and temperature at standard altitude levels for every winds aloft reporting station in the United States. This is the same raw forecast data that the navigation log calculator uses internally to compute wind-corrected headings and ground speeds.

Altitude Levels

Data is provided at the following standard levels (feet MSL): 3000, 6000, 9000, 12000, 18000, 24000, 30000, 34000, and 39000. Not all stations report temperature at every level. Wind direction and speed may be null for calm or light/variable conditions.

Forecast Periods

6-hour — Short-range forecast, most accurate for near-term flights

12-hour — Medium-range forecast for flights departing later in the day

24-hour — Long-range forecast for next-day planning

Response Structure

The response includes the forecast validity window (ValidTime, ForUseStartTime, ForUseEndTime) and a list of reporting sites. Each site has an identifier, coordinates, and a dictionary of wind/temperature data keyed by altitude level (e.g., "3000", "6000"). Wind direction is in degrees true (the direction wind is blowing *from*), speed is in knots, and temperature is in degrees Celsius.

Parameters

Name	In	Type	Description
forecast*	path	integer	Forecast period in hours. Must be 6, 12, or 24.

Response Schema

200Returns the winds aloft forecast dataWindsAloftDto

validTimedate-time

Valid time for the forecast data.

forUseStartTimedate-time

Start of the forecast use period.

forUseEndTimedate-time

End of the forecast use period.

400The forecast period is not 6, 12, or 24ApiErrorResponse

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.

503The winds aloft data source is temporarily unavailableApiErrorResponse