{"openapi":"3.1.0","info":{"title":"METAR / TAF Aviation Weather API","version":"1.0.0","description":"Live aviation weather for any airport as an API, relayed from NOAA's Aviation Weather Center. Get the current METAR observation for an ICAO station (e.g. KJFK → New York JFK: temperature, dewpoint, wind, visibility, altimeter, cloud layers, flight category VFR/MVFR/IFR/LIFR and the raw report) or the TAF terminal aerodrome forecast. Query one station or up to 10 at once (KJFK,EGLL,EDDF). Both decoded fields and the raw text are returned. Ideal for flight-planning tools, aviation dashboards, drone/UAV operations and weather apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/metar-api","description":"oanor gateway"}],"tags":[{"name":"Aviation Weather"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/metar":{"get":{"operationId":"get_v1_metar","tags":["Aviation Weather"],"summary":"Current METAR observation(s) for ICAO station(s)","description":"","parameters":[{"name":"icao","in":"query","required":true,"description":"ICAO station id, e.g. KJFK (up to 10 comma-separated)","schema":{"type":"string"},"example":"KJFK"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"raw":"METAR KJFK 310451Z 03004KT 10SM CLR 09/06 A3010 RMK AO2 SLP192 T00890056 401940083 $","name":"New York/JF Kennedy Intl, NY, US","wind":{"speed_kt":4,"direction_deg":30},"cover":"CLR","clouds":[],"station":"KJFK","latitude":40.6392,"longitude":-73.7639,"dewpoint_c":5.6,"visibility":"10+","elevation_m":3,"observed_at":"2026-05-31T05:00:00.000Z","altimeter_hpa":1019.4,"temperature_c":8.9,"flight_category":"VFR","sea_level_pressure_hpa":1019.2},"meta":{"timestamp":"2026-05-31T05:48:01.446Z","request_id":"525a8d2d-f740-4b58-8e93-b2b9f4694c4d"},"status":"ok","message":"METAR retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/taf":{"get":{"operationId":"get_v1_taf","tags":["Aviation Weather"],"summary":"Terminal aerodrome forecast (TAF)","description":"","parameters":[{"name":"icao","in":"query","required":true,"description":"ICAO station id, e.g. KJFK (up to 5 comma-separated)","schema":{"type":"string"},"example":"KJFK"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"raw":"TAF KJFK 310536Z 3106/0112 36005KT P6SM SKC FM311200 29010KT P6SM FEW080 FM311600 24014KT P6SM SCT080 FM311900 20016KT P6SM BKN080 FM010300 27008KT P6SM BKN100 FM010600 33007KT P6SM BKN080","name":"New York/JF Kennedy Intl","station":"KJFK","valid_to":"2026-06-01T12:00:00.000Z","issued_at":"2026-05-31T05:36:00.000Z","valid_from":"2026-05-31T06:00:00.000Z"},"meta":{"timestamp":"2026-05-31T05:48:01.758Z","request_id":"cfc2a6b2-0688-4834-a784-b4c45fd288d8"},"status":"ok","message":"TAF retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & field reference","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live observations relayed from NOAA; not cached. METAR = current report, TAF = forecast.","fields":["station","name","observed_at","temperature_c","dewpoint_c","wind","visibility","altimeter_hpa","weather","clouds","flight_category","raw"],"source":"NOAA Aviation Weather Center (aviationweather.gov)","endpoints":["/v1/metar","/v1/taf","/v1/meta"],"station_format":"4-letter ICAO, e.g. KJFK (New York JFK), EGLL (London Heathrow), EDDF (Frankfurt)","flight_categories":{"IFR":"Instrument","VFR":"Visual","LIFR":"Low IFR","MVFR":"Marginal VFR"}},"meta":{"timestamp":"2026-05-31T05:48:01.831Z","request_id":"5ed67de2-b890-4351-afb9-24855631da7b"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":45000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":220000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5500,"monthly_call_quota":1100000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/metar-api"}