airports

Get weather conditions for given airport

Returns weather for an airport in the form of a decoded METAR, starting from the latest report and working backwards in time as more data is requested. Data is provided in parsed, human-readable, and raw formats.

get/airports/{id}/weather/observations

Request

Path parameters

idstring required

ICAO, IATA or LID ID of destination airport to fetch. ICAO is highly preferred to prevent ambiguity.

Query parameters

temperature_units'C' | 'F' | 'Celsius' | 'Fahrenheit'

Units to use for temperature fields.

return_nearby_weatherboolean

If the requested airport does not have a weather conditions report then the weather for the nearest airport within 30 miles will be returned instead.

timestampstring date-time
Example:2021-12-31T19:59:59Z

Timestamp from which to begin returning weather data in a 1 day range. Because weather data is returned in reverse chronological order, all returned weather reports will be from before this timestamp. If unspecified, weather is returned starting from now up to or less than the user history limit, normally 14 days.

max_pagesinteger

Maximum number of pages to fetch. This is an upper limit and not a guarantee of how many pages will be returned.

cursorstring

Opaque value used to get the next batch of data from a paged collection.

Response

OK

num_pagesinteger required

Number of pages returned

Example response

{
  "observations": [
    {
      "cloud_friendly": "Overcast skies",
      "conditions": "BR",
      "time": "2021-12-31T19:59:59Z",
      "wind_friendly": "Very windy"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.