Weather API

Download OpenAPI specification:Download

Introduction

The Weather APIs, part of the FlightStats APIs, includes METAR, TAF (Terminal Aerodrome/Area Forecast), and Zone Forecasts.

METAR reports provide up-to-date information on current weather conditions at an airport; we enrich these reports with tag annotations identifying prevailing conditions and notable hazards that may impact aviation.

Our two forecast products, TAF and Zone Forecasts, are complementary in scope.

  • TAF provides a detailed forecast for the immediate vicinity of an airport, generally covering a 9 to 12 hour window (sometimes greater).
  • Zone Forecasts provide longer-term and more geographically broad outlook via day-by-day forecasts generally stretching up to about a week in the future.

Weather APIs answer questions such as:

  • What is the current conditions at the airport?
  • What is the long term forecast at the airport?
  • Is there a possibility of aviation-related weather problems at the airport?

Licensing

The Weather APIs are standard APIS and are included in our Commercial and Contract plans.

A breakdown of the available plans is available on Get evaluation account

Tags

METAR reports are annotated with additional tags providing summary information on the report. All tags are optional.

Tag Key Possible Values Description
Prevailing Conditions
  1. Hurricane
  2. Tornado
  3. Volcanic Ash
  4. Ice
  5. Thunderstorms
  6. Snow
  7. Dust / Sand Storms
  8. Foggy
  9. Smoke
  10. Patchy Fog
  11. Windy
  12. Breezy
  13. Rain
  14. High Chance of Rain
  15. Showers
  16. Low Chance of Showers
  17. Cloudy
  18. Partly Cloudy
  19. Smog
  20. Mostly Clear
  21. Clear
  22. Partly Sunny
  23. Sunny
Prevailing weather conditions. Conditions are considered in the priority listed; the report is tagged with only the highest-priority condition.
Visibility 0..5 Visibility hazard rating, based on sky condition; 5 is worst
Wind 0..5 Wind hazard rating; 5 is worst
Precipitation 0..3 Precipitation hazard rating; 3 is worst
Freezing 0..4 Hazard rating for freezing conditions; 4 is worst
Severe Weather 0..30 Hazard rating for severe weather phenomena; 30 is worst

Schemas

Click the download button at the top of this document to download the OpenApi spec for this API. Other schemas:

Long term support

Extended fields

Example implementations

FlightStats Current Conditions - Shows METAR and Weather Zone forecast for PDX

Cirium Airport Weather Impact - Dashboard of delay index and current weather conditions (METAR) combined

Related products

Weather (Laminar Data Hub) - Metar and TAFs are also available on Laminar Data Hub (in IWXXM format)

SIGMET (Laminar Data Hub) - Significant Meteorological Information weather advisories are available on Laminar Data Hub

Authentication

appIdQueryParam

ID of the application making the request

Security Scheme Type API Key
Query parameter name: appId

appKeyQueryParam

Authentication key of the application making the request

Security Scheme Type API Key
Query parameter name: appKey

appIdHeader

ID of the application making the request

Security Scheme Type API Key
Header parameter name: appId

appKeyHeader

Authentication key of the application making the request

Security Scheme Type API Key
Header parameter name: appKey

All for airport

Retrieve all weather products (METAR, TAF, and Zone Forecast) for the airport.

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PDX

Airport code

query Parameters
codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
No sample

METAR for airport

Retrieve the most current available METAR weather report for the aerodrome around a given airport. METAR reports describe current conditions and are updated about once an hour.

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PDX

Airport code

query Parameters
codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
No sample

TAF for airport

Retrieve the most current available Terminal Aerodrome Forecast (TAF) for the airport. TAFs forecast weather conditions for the area within a 5 mile radius from the center of the airport runway complex.

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PDX

Airport code

query Parameters
codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
No sample

Zone Forecast for airport

Retrieve the most current available zone forecast for the airport. Zone forecasts can cover several days, and apply to a more extensive area around the airport than TAFs.

path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PDX

Airport code

query Parameters
codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh"

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
No sample
)