TAFs
GET/api/v1/tafs/{icaoCodeOrIdent}Student Pilot

Get Taf By Icao Code Or Ident

Gets the current TAF for a specific airport, including all forecast periods with expected weather conditions (wind, visibility, sky cover, precipitation, turbulence, and icing).

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/tafs/KJFK"

Description

GET /api/v1/tafs/KDFW — by ICAO code
GET /api/v1/tafs/DFW — by FAA identifier

Parameters

NameInTypeDescription
icaoCodeOrIdent*pathstringICAO code or FAA identifier (e.g., KDFW, DFW). Case-insensitive.

Response Schema

200Returns the TAF with all forecast periodsTafDto
rawTextstringnullable

Raw TAF forecast text as received from the source. ex: KORD 061728Z 0618/0724 21012KT P6SM BKN250

stationIdstringnullable

ICAO station identifier (e.g., KDFW).

issueTimestringnullable

Time the TAF was issued in ISO 8601 format.

bulletinTimestringnullable

Bulletin time in ISO 8601 format.

validTimeFromstringnullable

Start of the TAF valid period in ISO 8601 format.

validTimeTostringnullable

End of the TAF valid period in ISO 8601 format.

remarksstringnullable

TAF remarks.

latitudenumbernullable

Station latitude in decimal degrees (WGS 84).

longitudenumbernullable

Station longitude in decimal degrees (WGS 84).

elevationMnumbernullable

Station elevation in meters MSL. This field is in meters (not feet) because it originates from the NOAA Aviation Weather API which uses ICAO standard units.

404If no TAF is found for the airportApiErrorResponse
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.

Search Documentation

Search docs, endpoints, and schemas