AvioWeather Developer API

Returns the most recent METAR for the given ICAO airport, fully decoded. Served from the 5-minute pipeline snapshot (the same data the AvioWeather apps consume); falls back to a live NOAA fetch if the station is not in the current snapshot. source tells you which path answered.

Path parameters

icao

string Four-letter ICAO code, e.g. LIRF. Case-insensitive.

Example response

{
  "icao": "LIRF",
  "name": "Roma Fiumicino",
  "latitude": 41.8, "longitude": 12.24, "elevation_m": 5,
  "raw": "LIRF 191420Z 22008G18KT 9999 FEW040 SCT100 17/09 Q1018",
  "observed_at": "2026-05-19T14:20:00Z",
  "flight_category": "VFR",
  "wind": { "direction_deg": 220, "variable": false, "speed_kt": 8, "gust_kt": 18 },
  "visibility": { "statute_miles": 6.21, "meters": 9999 },
  "clouds": [ { "cover": "FEW", "base_ft": 4000 }, { "cover": "SCT", "base_ft": 10000 } ],
  "weather": [],
  "temperature_c": 17, "dewpoint_c": 9,
  "altimeter_hpa": 1018, "sea_level_pressure_hpa": null,
  "source": "pipeline", "age_seconds": 95
}

Batch METAR for up to 20 ICAOs in a single call, resolved from one snapshot read. Each METAR returned counts as 1 against your quota. Unknown ICAOs come back as { "icao": "XXXX", "error": "NOT_FOUND" } in the array rather than failing the whole request.

Query parameters

icao

string Comma-separated ICAO codes. Maximum 20 per request.

{ "count": 3, "metars": [ { "icao": "LIRF", … }, … ] }

Station metadata (name, coordinates, elevation) plus the latest flight category and observation time.

{
  "icao": "LIRF", "name": "Roma Fiumicino",
  "latitude": 41.8, "longitude": 12.24, "elevation_m": 5,
  "flight_category": "VFR", "last_observation_at": "2026-05-19T14:20:00Z",
  "source": "pipeline"
}

Current TAF (terminal aerodrome forecast), raw plus decoded forecast periods (wind, visibility, clouds, weather, change indicator).

{
  "icao": "LIRF",
  "raw": "TAF LIRF 191100Z 1912/2012 22010KT 9999 FEW040 …",
  "issued_at": "2026-05-19T11:00:00Z",
  "valid_from": "2026-05-19T12:00:00Z",
  "valid_to": "2026-05-20T12:00:00Z",
  "forecast": [
    { "from": "2026-05-19T12:00:00Z", "to": "2026-05-20T12:00:00Z",
      "change_indicator": null, "wind": { "direction_deg": 220, "speed_kt": 10 },
      "visibility": { "meters": 9999 }, "clouds": [ … ], "weather": [] }
  ]
}

Active SIGMETs, parsed: canonical hazard tag plus the affected-area polygon as [lat, lon] rings. Optional hazard query parameter to filter (TS, TURB, ICE, MTW, VA).

{
  "count": 2,
  "sigmets": [
    { "id": "…", "hazard": "TS", "raw_text": "…",
      "valid_from": "…", "valid_to": "…",
      "coordinates": [ [45.1, 9.2], [45.6, 10.1], … ] }
  ]
}

Every decoded METAR observed for the station across a UTC date range (max 60 days per request). The 60-day cap is per call, not the depth of the archive: history reaches back roughly 20 years — to go further back, request consecutive 60-day windows by shifting the from/to dates. Served from the durable archive; missing days are backfilled on demand from Iowa State ASOS (open data) and cached.

Query parameters

from

string UTC start day YYYY-MM-DD.

to

string UTC end day YYYY-MM-DD (inclusive).

{
  "icao": "LIRF", "from": "2026-05-01", "to": "2026-05-07",
  "count": 336, "sources": ["iowa"],
  "observations": [ { "observed_at": "…", "raw": "…", "flight_category": "VFR", "wind": { … }, … } ]
}

Returns remaining monthly quota for the calling key. Does not decrement the counter.

{
  "tier": "pro",
  "quota": 100000,
  "used": 12483,
  "remaining": 87517,
  "reset_iso": "2026-06-01T00:00:00Z",
  "rate_limit_rps": 30
}