TAF
TAFs (Terminal Aerodrome Forecasts) are standardized aviation weather forecasts that describe expected conditions at an airport over a defined period. They use a compact text format similar to METARs but represent forecasted rather than observed weather.
The TAF endpoints provide access to both raw TAF reports and decoded forecast data. Decoded TAFs convert the encoded text into structured, time-segmented fields to simplify application development and analysis.
Raw, Short, or Decoded Responses
We offer three API response models for TAFs - Raw, Short, and Decoded - allowing you to choose between original report text, a streamlined summary, or fully structured data optimized for application use.
1. Raw Response
All TAF endpoints return the standardized raw TAF text by default. For consistency, you can optionally append/rawto the endpoint path.
Example:
https://api.checkwx.com/v2/taf/ktpa
https://api.checkwx.com/v2/taf/ktpa/raw
Response:
{
"results": 1,
"data": [
"TAF KTPA 260129Z 2601/2706 VRB04KT P6SM FEW040 BKN250 FM261400 21006KT P6SM SCT030 SCT250 FM261800 24008KT P6SM SCT050 BKN250 PROB30 2618/2621 25010G20KT 3SM TSRA BKN050CB FM270200 VRB04KT P6SM FEW040 BKN250"
]
}2. Short Response
Adding/short to the end of any TAF endpoint path to receive a simplified JSON response. This includes the ICAO code, observed time, and the raw TAF text.
Example:
https://api.checkwx.com/v2/taf/ktpa/short
Response:
{
"results": 1,
"data": [
{
"icao": "KTPA",
"raw_text": "TAF KTPA 260129Z 2601/2706 VRB04KT P6SM FEW040 BKN250 FM261400 21006KT P6SM SCT030 SCT250 FM261800 24008KT P6SM SCT050 BKN250 PROB30 2618/2621 25010G20KT 3SM TSRA BKN050CB FM270200 VRB04KT P6SM FEW040 BKN250",
"issued": "2026-06-26T01:29:00Z"
}
]
}3. Decoded Response
Adding/decodedto any TAF endpoint to receive a fully parsed TAF in structured JSON format. The response includes weather parameters in key-value pairs for easier processing.
Example:
https://api.checkwx.com/v2/taf/ktpa/decoded
Response:
{
"results": 1,
"data": [
{
"icao": "KTPA",
"raw_text": "TAF KTPA 260129Z 2601/2706 VRB04KT P6SM FEW040 BKN250 FM261400 21006KT P6SM SCT030 SCT250 FM261800 24008KT P6SM SCT050 BKN250 PROB30 2618/2621 25010G20KT 3SM TSRA BKN050CB FM270200 VRB04KT P6SM FEW040 BKN250",
"issued": "2026-06-26T01:29:00Z",
"period": {
"from": "2026-06-26T01:00:00Z",
"to": "2026-06-27T06:00:00Z"
},
"report": {
"type": "TAF",
"status": "Forecast Report"
},
"station": {
"icao": "KTPA",
"iata": "TPA",
"name": "Tampa International Airport",
"geometry": {
"type": "Point",
"coordinates": [
-82.5332,
27.9755
]
},
"location": "Tampa, Florida, United States"
},
"forecast": [
{
"section": "2601/2706 VRB04KT P6SM FEW040 BKN250",
"change": {
"code": "INITIAL",
"period": {
"from": "2026-06-26T01:00:00Z",
"to": "2026-06-27T06:00:00Z"
},
"text": "Initial or prevailing forecast"
},
"clouds": [
{
"code": "FEW",
"feet": 4000,
"meters": 1219.0,
"text": "Few"
},
{
"code": "BKN",
"feet": 25000,
"meters": 7620.0,
"text": "Broken"
}
],
"wind": {
"speed": {
"kts": 4,
"mph": 5,
"kph": 7,
"mps": 2
},
"direction": "VRB"
},
"visibility": {
"miles": 6.0,
"meters": 9656.06,
"text": "Greater than 6 miles"
}
},
{
"section": "FM261400 21006KT P6SM SCT030 SCT250",
"change": {
"code": "FM",
"period": {
"from": "2026-06-26T14:00:00Z"
},
"text": "Sudden rapid change"
},
"clouds": [
{
"code": "SCT",
"feet": 3000,
"meters": 914.0,
"text": "Scattered"
},
{
"code": "SCT",
"feet": 25000,
"meters": 7620.0,
"text": "Scattered"
}
],
"wind": {
"degrees": 210,
"speed": {
"kts": 6,
"mph": 7,
"kph": 11,
"mps": 3
},
"direction": "SSW"
},
"visibility": {
"miles": 6.0,
"meters": 9656.06,
"text": "Greater than 6 miles"
}
},
{
"section": "FM261800 24008KT P6SM SCT050 BKN250",
"change": {
"code": "FM",
"period": {
"from": "2026-06-26T18:00:00Z"
},
"text": "Sudden rapid change"
},
"clouds": [
{
"code": "SCT",
"feet": 5000,
"meters": 1524.0,
"text": "Scattered"
},
{
"code": "BKN",
"feet": 25000,
"meters": 7620.0,
"text": "Broken"
}
],
"wind": {
"degrees": 240,
"speed": {
"kts": 8,
"mph": 9,
"kph": 15,
"mps": 4
},
"direction": "WSW"
},
"visibility": {
"miles": 6.0,
"meters": 9656.06,
"text": "Greater than 6 miles"
}
},
{
"section": "PROB30 2618/2621 25010G20KT 3SM TSRA BKN050CB",
"change": {
"code": "PROB",
"period": {
"from": "2026-06-26T18:00:00Z",
"to": "2026-06-26T21:00:00Z"
},
"probability": 30,
"text": ""
},
"clouds": [
{
"code": "BKN",
"feet": 5000,
"type": {
"code": "CB",
"text": "Cumulonimbus"
},
"meters": 1524.0,
"text": "Broken"
}
],
"conditions": [
{
"code": "TSRA",
"text": "Thunderstorm with Rain"
}
],
"wind": {
"degrees": 250,
"speed": {
"kts": 10,
"mph": 12,
"kph": 19,
"mps": 5
},
"gust": {
"kts": 20,
"mph": 23,
"kph": 37,
"mps": 10
},
"direction": "WSW"
},
"visibility": {
"miles": 3.0,
"meters": 4828.03,
"text": "3 miles"
}
},
{
"section": "FM270200 VRB04KT P6SM FEW040 BKN250",
"change": {
"code": "FM",
"period": {
"from": "2026-06-27T02:00:00Z"
},
"text": "Sudden rapid change"
},
"clouds": [
{
"code": "FEW",
"feet": 4000,
"meters": 1219.0,
"text": "Few"
},
{
"code": "BKN",
"feet": 25000,
"meters": 7620.0,
"text": "Broken"
}
],
"wind": {
"speed": {
"kts": 4,
"mph": 5,
"kph": 7,
"mps": 2
},
"direction": "VRB"
},
"visibility": {
"miles": 6.0,
"meters": 9656.06,
"text": "Greater than 6 miles"
}
}
]
}
]
}TAF by ICAO
Returns the latest TAF data for one or more ICAO codes
Endpoint Path
/v2/taf/{icao}
Path Parameters
icao
string
Required
A single ICAO code or multiple ICAO codes seperated by commas
Maximum of 25 comma seperated ICAO codes per request
Examples
https://api.checkwx.com/v2/taf/KTPA
https://api.checkwx.com/v2/taf/KJFK/decoded
https://api.checkwx.com/v2/taf/KDFW,KLAX/short
TAF Nearest to ICAO
Returns the latest TAF data nearest to the requested ICAO.
Endpoint Path
/v2/taf/{icao}/nearest
Path Parameters
icao
string
Required
A single ICAO code
Querystring Parameters
limit
integer
Optional
Number of ICAOs with a TAF to return
Default: 1
minimum value: 1
maximum value: 25
include
boolean
Optional
Include the origin ICAO's TAF in the results
Default: false
Examples
https://api.checkwx.com/v2/taf/nearest/KTPA
https://api.checkwx.com/v2/taf/nearest/KJFK/decoded
https://api.checkwx.com/v2/taf/nearest/JKFK/short?limit=3
https://api.checkwx.com/v2/taf/nearest/JKFK/short?limit=3&include=true
Notes
- Additional postion fields are included in the decoded response data to show the distance and direction from the specified ICAO.
TAF within Radius of ICAO
Returns the latest TAF data within a specified radius of a single ICAO code
Endpoint Path
/v2/taf/{icao}/radius/{radius}
Path Parameters
icao
string
Required
A single ICAO code
radius
integer
Required
The surrounding radius in miles
minimum value: 1
maximum value: 250
Querystring Parameters
limit
integer
Optional
Number of ICAOs with a TAF to return
Default: 10
minimum value: 1
maximum value: 25
include
boolean
Optional
Include the origin ICAO's TAF in the results
Default: false
Examples
https://api.checkwx.com/v2/taf/KJFK/radius/50
https://api.checkwx.com/v2/taf/KJFK/radius/50?limit=5
Notes
- The results are sorted based on the distance from the requested ICAO code
- Additional postion fields are included in the decoded response data to show the distance and direction from the specified ICAO.
TAF Nearest to Latitude/Longitude
Returns the latest TAF data for nearest to the latitude and longitude
Endpoint Path
/v2/taf/lat/{latitude}/lon/{longitude}
Path Parameters
latitude
float
Required
The latitude in decimal degrees
minimum value: -90
maximum value: 90
longitude
float
Required
The longitude in decimal degrees
minimum value: -180
maximum value: 180
Querystring Parameters
limit
integer
Optional
Number of ICAOs with a TAF to return
Default: 10
minimum value: 1
maximum value: 25
Examples
https://api.checkwx.com/v2/taf/lat/40.72/lon/-73.99
https://api.checkwx.com/v2/taf/lat/40.72/lon/-73.99/decoded
Notes
- Additional postion fields are included in the decoded response data to show the distance and direction from the specified Latitude/Longitude
TAF within Radius of Latitude/Longitude
Returns the latest TAF data within a specified radius of the latitude and longitude
Endpoint Path
/v2/taf/lat/{latitude}/lon/{longitude}/radius/{radius}
Path Parameters
latitude
float
Required
The latitude in decimal degrees
minimum value: -90
maximum value: 90
longitude
float
Required
The longitude in decimal degrees
minimum value: -180
maximum value: 180
radius
integer
Required
The surrounding radius in miles
minimum value: 1
maximum value: 250
Querystring Parameters
limit
integer
Optional
Number of ICAOs with a TAF to return
Default: 10
minimum value: 1
maximum value: 25
Examples
https://api.checkwx.com/v2/taf/lat/40.72/lon/-73.99/radius/25
Notes
- The results are sorted based on the distance from the requested ICAO code
- Additional postion fields are included in the decoded response data to show the distance and direction from the specified Latitude/Longitude
Endpoints+
Endpoints+ are premium API endpoints exclusively available to users with a Developer, Business, or Enterprise subscription plan. Compare Plan Features.
Previous TAFs by ICAO
Returns the previous TAF data for a one or more ICAO codes
Endpoint Path
/v2/taf/{icao}/previous/{limit}
Path Parameters
icao
string
Required
A single ICAO code or multiple ICAO codes seperated by commas
Maximum of 25 comma seperated ICAO codes per request
limit
integer
Required
The number of previous TAFs to return for each ICAO
minimum value: 2
maximum value: 50
Examples
https://api.checkwx.com/v2/taf/KTPA/previous/10
https://api.checkwx.com/v2/taf/KJFK,KLAX/previous/10
TAFs by Country
Returns the latest TAF data for multiple stations within a specified country code
Endpoint Path
/v2/taf/country/{code}
Path Parameters
code
string
Required
A single, two character country code
Examples
https://api.checkwx.com/v2/taf/country/GB
https://api.checkwx.com/v2/taf/country/GB/decoded
Notes
- Decoded TAFs for this endpoint can be quite large
- For the United States, it is recommened to instead use the TAFs by State endpoint
TAFs by State (US)
Returns the latest TAF data for multiple stations within the United States, specified by a state code
Endpoint Path
/v2/taf/state/{code}
Path Parameters
code
string
Required
A single, two character state code
Examples
https://api.checkwx.com/v2/taf/state/FL
https://api.checkwx.com/v2/taf/state/FL/decoded
Notes
- Decoded TAFs for this endpoint can be quite large
TAF Fields
The following table lists the fields which are returned by all TAF decoded endpoints.
-
icao
string
Examples:
ICAO airport code or station indicator
KPIE -
raw_text
string
The unparased TAF text
TAF KJFK 232136Z 32003KT 10SM ... -
report
object
-
type
string
Report type
TAF -
flags
string
Report flags
AMND , COR -
status
string
Report status text
Ammended Report , Corrected Report
-
-
issued
string
DateTime the TAF was issued
2025-12-25 16:00:00 -
period
object
-
from
string
DateTime the TAF period begins
2025-12-24 16:00:00 -
to
string
DateTime the forecast period ends
2025-12-25 16:00:00
-
-
station
object
-
name
string
Station name
John F Kennedy International Airport -
location
string
City, (State/Province), Country
New York , New York , United States -
geometry
object
GeoJSON object
-
point
string literal
Indicates place of interest
Point -
coordinates
array
GeoJSON order [longitude, latitude]
[-73.779, 40.639]
-
-
-
forecast
object[]
-
section
string
Forecast section
FM022000 24007KT P6SM VCSH SCT025 BKN050 -
change
object
Forecast change indicator
-
code
string
Change indicator code
FM -
text
string
Human-readable translation of the code
Sudden rapid change -
period
object
-
from
string
DateTime the forecast period begins
2025-12-24 16:00:00 -
to
string
DateTime the forecast period ends
2025-12-25 16:00:00
-
-
-
clouds
object[]
-
code
string
Cloud abbreviation code
OVC -
text
string
Human-readable translation of the code
Overcast -
feet
integer
Cloud height in feet above ground level
3200 -
meters
integer
Cloud height in meters above ground level
975
-
-
conditions
object[]
-
code
string
Weather conditions abbreviation code
FG , +SHRA -
text
string
Human-readable translation of the code
Fog , Heavy rain showers
-
-
wind
object
-
degrees
integer
Wind direction in degrees
230 -
direction
string
Wind compass direction
SW -
speed
object
-
kts
integer
Speed in knots
6 -
mph
integer
Speed in miles per hour
7 -
kph
integer
Speed in kilometers per hour
11 -
mps
integer
Speed in meters per second
3
-
-
gust
object
-
kts
integer
Gust in knots
20 -
mph
integer
Gust in miles per hour
21 -
kph
integer
Gust in kilometers per hour
37 -
mps
integer
Gust in meters per second
10
-
-
-
-
position
object
Included for Nearest/Radius endpoints
-
points
string
Reference point, either ICAO or coordinates
KJFK -> KLGA -
bearing
integer
True bearing from request point -> to results point
180 -
distance
object
-
meters
float
Distance in meters
10,000 -
miles
float
Distance in nautical miles
5.4
-
-