Introduction

This document is intended for users who want to write applications that interact with our aviation weather data API.

It explains basic concepts of the API itself and provides an overview of the different functions that our API supports.

 

Getting Started

This documentation is structured first by a group of related functionality: Station, METAR, TAF, etc., and then by endpoint. Endpoints are a specific method within that API that performs one action and is located at a specific URL.

  • Our API is organized around REST
  • All requests should be made over SSL
  • All request and response bodies, including errors, are encoded in JSON by default

Each endpoint in this documentation is described using several parts:

  • Base URL https://api.checkwx.com/
  • API Endpoint
  • Header Parameters
  • URL Parameters
  • Querystring Parameters
 

Authentication

All API endpoints require an API key which is unique for each user. Your specific API key can be found on your Account Settings page.

In order to use our services you must provided your API key as a Header Parameter with each request as shown in our examples.

If you are currently logged into our website, we have already included your API key in the examples. Otherwise just replace YOUR_API_KEY with your actual API key.

 

JSON Response

JSON (JavaScript Object Notation) is a simple machine-readable data-interchange format that provides a text representation of arbitrary data structures. All of our API response bodies consist of a UTF-8-encoded, JSON-formatted object, including errors.

You can familiarize yourself with the core concepts of the JSON data format at json.org .
 

JSON Pretty Print

Normally a JSON formatted response data is compressed in a single line standard format. However for human readability, you can specify a Querysting parameter which will return the JSON with indentation, line wraps and spacing. This is especially useful when viewing the response JSON using CURL on the commandline.

Querystring Parameters

Parameter Description Example
pretty=1 Pretty print JSON response. https://api.checkwx.com/station/kjfk?pretty=1
 

API Limits

All of our API Plans have different levels of daily request limits. Each API call you make to our services counts as one request, regardless of the number of parameters.

To illustrate this concept, see the examples below:

Example Requests Number of API Calls
https://api.checkwx/com/station/KPIE
https://api.checkwx/com/station/KSPG
https://api.checkwx/com/station/KLAL
3
https://api.checkwx/com/station/KPIE,KSPG,KLAL 1

Should you exceed your daily request limit, the API service will block your incoming requests and return a "402 : Over Quota" response.

The daily rate limit counter will reset to zero at 00:00 UTC.

To prevent exceeding your request limit you should consider caching the responses:

  • METAR and TAF requests should be requested and then cached for at least 15 minutes
  • STATION requests should be requested and then cached for at least 24 hours

To improve connections and experiences for all our users, we block some accounts when we see suspicious activity or other overloads on our system:

  • Creating multiple API accounts to circumvent API limits
  • Polling aggressively instead of caching responses
  • Making API calls with a high concurrency

Users that excessively or persistently exceed their rate limits may have their accounts disabled.

 

Examples

Each endpoint in this document has an example using CURL. Additionally we have basic examples for:  Javascript, JQuery, Node.js, PHP, Python and Ruby.

There are also some good examples on Github for working with our API.   One recommended repo is api.checkwx.com-examples.

  • If you are currently logged into our website, we have already included your API key in the examples.
  • If you are not logged in, just replace YOUR_API_KEY with your actual API key when copying an example.
  • In all of our endpoint descriptions, URL Parameters are displayed as :paramter.
  • Replace the parameter with the actual data value as shown below:
Example Parameter Actual Usage
https://api.checkwx.com/station/:icao https://api.checkwx.com/station/KJFK
 

.NET Wrapper

Nathanael Nordentoft has written a public .NET/C# wrapper

The wrapper is written to give users three ways of communicating with our API:

  • The RAW JSON services which will deliver the raw JSON response and HTTP status code from the API
  • The RAW XML services which will deliver the raw XML response and HTTP status code from the API
  • The .NET object services which will deserialize and deliver domain objects from the delivered JSON
 

Error Messages

Successful API requests are returned with a status code of 200.

If you receive a status code in the range of 400 to 450, please check the error section in the JSON response data for the exact error message and resolution.

Code Name Description
200 OK Successful request and response
400 Bad Request Malformed parameters or other bad request
401 Unauthorized Your API key is invalid
402 Over quota Over plan quota on this endpoint
403 Forbidden Invalid request
404 Not found The resource or endpoint does not exist
422 Validation error A validation error occurred
50X Internal Server Error An error occurred with our API
 

Station

Stations are any Airport, Heliport, Seaplane Base, Gliderport, Weather Reporting Station, etc.

Stations are identified by a four-character alphanumeric ICAO code

 

Station Fields

The following table lists the fields which are returned by all Station endpoints.

Fields marked as Conditional will not be included in the JSON response data if no value exists for that field.

Therefore your code should check for the existence of these fields before attempting to access the data value to avoid any errors.

Field Type Description Conditional
icao string ICAO airport code or station indicator
name string Station name
activated string Activated Month/Year
city string City
country object Object with the following properties
.code string Country code abbreviation
.name string Country full text name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
elevation object Object with the following properties
.feet integer Elevation in feet
.meters integer Elevation in meters
.method string Method used to determine elevation - 'Surveyed' or 'Estimated'
iata string IATA airport code or station indicator
latitude object Object with the following properties
.decimal float Latitude in decimal degrees
.degrees string Latitude in degrees, minutes, seconds
longitude object Object with the following properties
.decimal float Longitude in decimal degrees
.degrees string Longitude in degrees, minutes, seconds
magnetic_variation object Object with the following properties
.position string The angle between magnetic north and true north
.year string Year of last magnetic variation determination
sectional string Station appears on this FAA Sectional chart (US/Canada)
state object Object with the following properties
.code string State/province abbreviation
.name string State/province full text name
status string Status - 'Operational' or 'Closed'
type string Type 'Airport', 'Heliport', 'Seaplane Base', etc.
useage string Useage 'Public', 'Private', 'Military', etc.
 

/station/:icao

Method
GET

Returns the latest Station information for a one or more ICAO codes.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request. Search for ICAO codes
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX,KMIA' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/:icao/radius/:radius

Method
GET

Returns the latest Station information for stations within a specified radius of a single ICAO code.

The results are sorted based on the distance from the requested ICAO code.

Additional response fields are included in the response data to show the distance and direction from the requested ICAO parameter.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from string Base location ICAO
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
icao A single ICAO code. (Multiple ICAO codes are not allowed for this endpoint) Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/radius/10' -H 'X-API-Key: YOUR_API_KEY'

###### single station with 'Airport' only filter
curl 'https://api.checkwx.com/station/KJFK/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/lat/:latitude/lon/:longitude

Method
GET

Returns the latest Station information for a single station nearest to the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude parameters.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


# latitude / longitude
curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99' -H 'X-API-Key: YOUR_API_KEY'

# latitude / longitude with 'Airport' only filter
curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/lat/:latitude/lon/:longitude/radius/:radius

Method
GET

Returns the latest Station information for multiple stations within a specified radius of the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude parameters.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99/radius/10' -H 'X-API-Key: YOUR_API_KEY'

curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/:icao/timestamp

Method
GET

Returns the latest Station timestamp for one or more ICAO codes.

The time data includes both local (station) and UTC timezone formats, timezone ID, and offsets to GMT/DST

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Response Fields

Field Type Description
icao string ICAO airport code or station indicator
name string Station name
timezone object Object with the following properties
.gmt signed integer Timezone offset subtracted or added to GMT time
.dst signed integer Timezone offset subtracted or added to GMT time including DST
.tzid string Timezone id text string
.zone string Timezone zone text string
timestamp object Object with the following properties
.local.current string Current local timestamp
.local.date string Local Date YYYY-MM-DD
.local.time string Local Time HH:MM:SS
.utc.current string Current UTC timestamp
.utc.date string UTC Date YYYY-MM-DD
.utc.time string UTC Time HH:MM:SS
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request.
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/timestamp' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX/timestamp' -H 'X-API-Key: YOUR_API_KEY'

 

/station/:icao/suntimes

Method
GET

Returns the latest Station sunrise/sunset and dawn/dusk times for one or more ICAO codes.

The time data includes both local (station) and UTC timezone formats.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Response Fields

Field Type Description
icao string ICAO airport code or station indicator
name string Station name
sunrise_sunset object Object with the following properties
.local.sun_rise string Sunrise local HH:MM:SS
.local.sun_set string Sunset local HH:MM:SS
.local.civil_dawn string Civil dawn local HH:MM:SS
.local.civil_dusk string Civil dusk local HH:MM:SS
.utc.sun_rise string Sunrise GMT HH:MM:SS
.utc.sun_set string Sunset GMT HH:MM:SS
.utc.civil_dawn string Civil dawn GMT HH:MM:SS
.utc.civil_dusk string Civil dusk GMT HH:MM:SS
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request.
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/suntimes' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX/suntimes' -H 'X-API-Key: YOUR_API_KEY'

 

METAR

METAR is a format for reporting current weather information.

METAR weather reports are predominantly used by pilots in fulfillment of a part of a pre-flight weather briefing, and by meteorologists, who use aggregated METAR information to assist in weather forecasting.

METARs typically come from airports or permanent weather observation stations. Reports are generated once an hour or half-hour, but if conditions change significantly, a report known as a special (SPECI) may be issued. Some METARs are encoded by automated airport weather stations located at airports, military bases, and other sites. Some locations still use augmented observations, which are recorded by digital sensors, encoded via software, and then reviewed by certified weather observers or forecasters prior to being transmitted. Observations may also be taken by trained observers or forecasters who manually observe and encode their observations prior to transmission.

A typical METAR contains data for the temperature, dew point, wind direction and speed, precipitation, cloud cover and heights, visibility, and barometric pressure. A METAR may also contain information on precipitation amounts, lightning, and other information that would be of interest to pilots or meteorologists.

METAR is the most common format in the world for the transmission of observational weather data. It is highly standardized through the International Civil Aviation Organization, which allows it to be understood throughout most of the world.

Our decoded METAR, decodes the raw METAR string to create keys and values for each part in a METAR. We also include additional weather information and conversions in the response data.

 

METAR Raw vs Decoded

By default all METAR endpoints return data in a raw string format.

By adding the /decoded URL Parameter to the end of any METAR endpoint, both the raw and decoded METAR will be included in the response data.

 

METAR Fields

The following table lists the fields which are returned by all /decoded METAR endpoints.

Fields marked as Conditional will not be included in the JSON response data if no value exists for that field.

Therefore your code should check for the existence of these fields before attempting to access the data value to avoid any errors.

Field Type Description Conditional
raw_text string Raw METAR text string
icao string ICAO airport code or station indicator
station.name string Station name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
observed datetime METAR observed ISODate in UTC
barometer.hg decimal Barometer in inches of mercury
barometer.kpa decimal Barometer in kilopascals
barometer.mb decimal Barometer in millibars
clouds array Array of cloud levels each with the following properties
code string Cloud abbreviation code
text string Cloud description text
feet decimal Base feet above ground level (AGL)
meters decimal Base meters above ground level (AGL)
ceiling.feet decimal Ceiling feet above ground level (AGL)
ceiling.meters decimal Ceiling meters above ground level (AGL)
conditions array Array of conditions levels each with the following properties
code string Condition abbreviation code
text string Condition description text
temperature.celsius integer Temperature in celsius
temperature.fahrenheit integer Temperature in fahrenheit
dewpoint.celsius integer Dewpoint in celsius
dewpoint.fahrenheit integer Dewpoint in fahrenheit
elevation.feet decimal Elevation of weather recording instrument in feet
elevation.meters decimal Elevation of weather recording instrument in meters
humidity.percent integer Humidity percentage
rain.inches integer Rainfall in inches
snow.inches integer Snowfall in inches
visibility.miles string Visibility in miles (Expressed as a string to support values like '1/2 mile')
visibility.miles_float float Visibility in miles
visibility.meters string Visibility in meters (Expressed as a string to support values like '> 9000')
visibility.meters_float float Visibility in meters
wind.degrees integer Wind direction in degrees
wind.speed_kts integer Wind speed in knots
wind.speed_kph integer Wind speed in kilometers per hour
wind.speed_mph integer Wind speed in miles per hour
wind.speed_mps integer Wind speed in meters per second
wind.gust_kts integer Wind gust in knots
wind.gust_kph integer Wind gust in kilometers per hour
wind.gust_mph integer Wind gust in miles per hour
wind.gust_mps integer Wind gust in meters per second
flight_category string One of the following flight category codes:
  • VFR
  • MVFR
  • IFR
  • LIFR
 

/metar/:icao

Method
GET

Returns the latest METAR report for a one or more ICAO codes.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request. Search for ICAO codes
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station - raw METAR
curl 'https://api.checkwx.com/metar/KJFK' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - raw METAR
curl 'https://api.checkwx.com/metar/KJFK,KLAX,KMIA' -H 'X-API-Key: YOUR_API_KEY'

###### single station - decoded METAR
curl 'https://api.checkwx.com/metar/KJFK/decoded' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - decoded METAR
curl 'https://api.checkwx.com/metar/KJFK,KLAX,KMIA/decoded' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/metar/:icao/radius/:radius

Method
GET

Returns one or more METAR reports within a specified radius of a single ICAO code.

The results are sorted based on the distance from the requested ICAO code.

Additional response fields are included in the response data to show the distance and direction from the requested ICAO.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from string Base location ICAO
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
icao A single ICAO code. (Multiple ICAO codes are not allowed for this endpoint) Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
decoded The response data will include decoded METAR key value pairs Optional
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/metar/KJFK/radius/20' -H 'X-API-Key: YOUR_API_KEY'

###### single station with 'Airport' only filter
curl 'https://api.checkwx.com/metar/KJFK/radius/20?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/metar/lat/:latitude/lon/:longitude

Method
GET

Returns a single METAR report nearest to the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


# latitude / longitude
curl 'https://api.checkwx.com/metar/lat/40.72/lon/-73.99' -H 'X-API-Key: YOUR_API_KEY'

# latitude / longitude with 'Airport' only filter
curl 'https://api.checkwx.com/metar/lat/40.72/lon/-73.99?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/metar/lat/:latitude/lon/:longitude/radius/:radius

Method
GET

Returns one or more METAR reports within a specified radius of the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


curl 'https://api.checkwx.com/metar/lat/40.72/lon/-73.99/radius/10' -H 'X-API-Key: YOUR_API_KEY'

curl 'https://api.checkwx.com/metar/lat/40.72/lon/-73.99/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

TAF

TAF is a format for reporting forecast weather information.

Terminal Aerodrome Forecast (TAF) is a format for reporting weather forecast information, particularly as it relates to aviation. TAFs are issued every six hours for major civil airfields: 0000, 0600, 1200 and 1800 UTC, and generally apply to a 24- or 30-hour period, and an area within approximately five statute miles (8.0 km) (or 5 nautical miles (9.3 km) in Canada) from the center of an airport runway complex. TAFS are issued every three hours for military airfields and some civil airfields and cover a period ranging from 3 hours to 30 hours.

TAFs complement and use similar encoding to METAR reports. They are produced by a human forecaster based on the ground. For this reason there are considerably fewer TAF locations than there are airports for which METARs are available. TAFs can be more accurate than Numerical Weather Forecasts, since they take into account local, small-scale, geographic effects.

In the United States the weather forecasters responsible for the TAFs in their respective areas are located within one of the 122 Weather Forecast Offices operated by the United States’ National Weather Service. In contrast, a trend type forecast (TTF), which is similar to a TAF, is always produced by a person on-site where the TTF applies. In the United Kingdom most TAFs at military airfields are produced locally, however TAFs for civil airfields are produced at the Met Office headquarters in Exeter.

TAF is the most common format in the world for the transmission of forecast weather data. It is highly standardized through the International Civil Aviation Organization, which allows it to be understood throughout most of the world.

Our decoded TAF, decodes the raw TAF to creates keys and values for each part in a TAF. We also include additional weather information and conversions in the response data.

 

TAF Raw vs Decoded

By default all TAF endpoints return data in a raw string format.

By adding the /decoded URL Parameter to the end of any TAF endpoint, both the raw and decoded TAF will be included in the response data.

 

TAF Fields

The following table lists the fields which are returned by all /decoded TAF endpoints.

Fields marked as Conditional will not be included in the JSON response data if no value exists for that field.

Therefore your code should check for the existence of these fields before attempting to access the data value to avoid any errors.

Field Type Description Conditional
raw_text string Raw TAF text string
icao string ICAO airport code or station indicator
station.name string Station name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
timestamp.issued datetime TAF issued ISODate in UTC
timestamp.from datetime Overall forecast from ISODate in UTC
timestamp.to datetime Overall forecast to ISODate in UTC
forecast array Array with the following properties
timestamp.from datetime Section forecast from ISODate in UTC
timestamp.to datetime Section forecast to ISODate in UTC
change.probability integer Change probability percentage
change.indicator.code string Change indicator abbreviation code
change.indicator.text string Change indicator text
change.indicator.desc string Change indicator description
clouds array Array of cloud levels each with the following properties
code string Cloud abbreviation code
text string Cloud description text
feet decimal Base feet above ground level (AGL)
meters decimal Base meters above ground level (AGL)
conditions array Array of conditions levels each with the following properties
code string Condition abbreviation code
text string Condition description text
visibility.miles string Visibility in miles (Expressed as a string to support values like '1/2 mile')
visibility.miles_float float Visibility in miles
visibility.meters string Visibility in meters (Expressed as a string to support values like '> 9000')
visibility.meters_float float Visibility in meters
wind.degrees integer Wind direction in degrees
wind.speed_kts integer Wind speed in knots
wind.speed_kph integer Wind speed in kilometers per hour
wind.speed_mph integer Wind speed in miles per hour
wind.speed_mps integer Wind speed in meters per second
wind.gust_kts integer Wind gust in knots
wind.gust_kph integer Wind gust in kilometers per hour
wind.gust_mph integer Wind gust in miles per hour
wind.gust_mps integer Wind gust in meters per second
turbulence array Array of turbulence levels each with the following properties
minimum.feet decimal Minimum altitiude in Feet AGL
minimum.meters decimal Minimum altitiude in Meters AGL
maximum.feet decimal Maximum altitiude in Feet AGL
maximum.meters decimal Maximum altitiude in Meters AGL
intensity.code string Intensity code
intensity.desc string Intensity description
icing array Array of icing levels each with the following properties
minimum.feet decimal Minimum altitiude in Feet AGL
minimum.meters decimal Minimum altitiude in Meters AGL
maximum.feet decimal Maximum altitiude in Feet AGL
maximum.meters decimal Maximum altitiude in Meters AGL
intensity.code string Intensity code
intensity.desc string Intensity description
 

/taf/:icao

Method
GET

Returns the latest TAF report for a one or more ICAO codes.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request. Search for ICAO codes
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station - raw TAF
curl 'https://api.checkwx.com/taf/KJFK' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - raw TAF
curl 'https://api.checkwx.com/taf/KJFK,KLAX,KMIA' -H 'X-API-Key: YOUR_API_KEY'

###### single station - decoded TAF
curl 'https://api.checkwx.com/taf/KJFK/decoded' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations - decoded TAF
curl 'https://api.checkwx.com/taf/KJFK,KLAX,KMIA/decoded' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/:icao/radius/:radius

Method
GET

Returns one or more TAF reports within a specified radius of a single ICAO code.

The results are sorted based on the distance from the requested ICAO code.

Additional response fields are included in the response data to show the distance and direction from the requested ICAO.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from string Base location ICAO
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
icao A single ICAO code. (Multiple ICAO codes are not allowed for this endpoint) Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
decoded The response data will include decoded TAF key value pairs Optional
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/taf/KJFK/radius/20' -H 'X-API-Key: YOUR_API_KEY'

###### single station with 'Airport' only filter
curl 'https://api.checkwx.com/taf/KJFK/radius/20?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/lat/:latitude/lon/:longitude

Method
GET

Returns a single TAF report nearest to the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


# latitude / longitude
curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99' -H 'X-API-Key: YOUR_API_KEY'

# latitude / longitude with 'Airport' only filter
curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/taf/lat/:latitude/lon/:longitude/radius/:radius

Method
GET

Returns one or more TAF reports within a specified radius of the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99/radius/10' -H 'X-API-Key: YOUR_API_KEY'

curl 'https://api.checkwx.com/taf/lat/40.72/lon/-73.99/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online