{"openapi":"3.1.0","info":{"title":"US Weather Alerts API","version":"1.0.0","description":"Live United States weather alerts as an API, straight from the National Weather Service. Get every active severe-weather warning, watch and advisory — tornado warnings, flash-flood and river-flood warnings, severe thunderstorm, winter storm, blizzard, excessive-heat, hurricane, red-flag and dozens more — filtered by US state, by a latitude/longitude point, or by NWS forecast/county zone, and refine by severity (Extreme, Severe, Moderate, Minor), urgency or event type. Each alert carries the event name, severity, urgency and certainty, the headline, the affected areas, the full description and the official protective-action instructions, plus the effective, onset, expires and ends times. See how many alerts are active nationwide and broken down by state, resolve any location to its NWS office, forecast zone and county, browse the full list of alert event types, and look up terms in the NWS weather glossary. Perfect for weather dashboards and safety apps, emergency-notification systems, smart-home automations, Discord/Slack bots and travel tools. No accounts, no upstream key. Covers the United States; for forecasts use the Weather API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/weatheralerts-api","description":"oanor gateway"}],"tags":[{"name":"Alerts"},{"name":"Reference"},{"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/alerts":{"get":{"operationId":"get_v1_alerts","tags":["Alerts"],"summary":"Active weather alerts","description":"","parameters":[{"name":"area","in":"query","required":false,"description":"2-letter state","schema":{"type":"string"},"example":"TX"},{"name":"point","in":"query","required":false,"description":"lat,lon","schema":{"type":"string"},"example":"38.9,-77.0"},{"name":"zone","in":"query","required":false,"description":"Zone id","schema":{"type":"string"},"example":"TXZ211"},{"name":"severity","in":"query","required":false,"description":"Extreme|Severe|Moderate|Minor","schema":{"type":"string"},"example":"Severe"},{"name":"event","in":"query","required":false,"description":"Event type","schema":{"type":"string"},"example":"Tornado Warning"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":0,"total":0,"alerts":[],"updated":"2026-06-01T00:02:08+00:00"},"meta":{"timestamp":"2026-06-01T00:03:40.622Z","request_id":"3c6928ae-667a-4327-ad99-8703f9f07b27"},"status":"ok","message":"Alerts 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/count":{"get":{"operationId":"get_v1_count","tags":["Alerts"],"summary":"Active alert counts by state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"land":76,"total":232,"marine":156,"by_area":[{"name":"PK","count":114},{"name":"PZ","count":26},{"name":"MO","count":11},{"name":"AN","count":9},{"name":"KS","count":7},{"name":"AR","count":6},{"name":"MT","count":6},{"name":"TN","count":6},{"name":"TX","count":6},{"name":"AK","count":5},{"name":"AL","count":4},{"name":"SD","count":4},{"name":"LA","count":3},{"name":"MD","count":3},{"name":"MS","count":3},{"name":"AM","count":2},{"name":"CA","count":2},{"name":"FL","count":2},{"name":"HI","count":2},{"name":"IN","count":2},{"name":"PH","count":2},{"name":"GM","count":1},{"name":"IL","count":1},{"name":"KY","count":1},{"name":"LH","count":1},{"name":"LO","count":1},{"name":"ND","count":1},{"name":"NM","count":1},{"name":"NY","count":1},{"name":"OK","count":1},{"name":"SC","count":1},{"name":"VA","count":1},{"name":"VT","count":1},{"name":"WA","count":1}],"by_zone_count":404},"meta":{"timestamp":"2026-06-01T00:03:40.931Z","request_id":"14f62ab2-27a1-4967-b2cf-d2b80e18cfb9"},"status":"ok","message":"Count 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/glossary":{"get":{"operationId":"get_v1_glossary","tags":["Reference"],"summary":"NWS weather glossary","description":"","parameters":[{"name":"term","in":"query","required":false,"description":"Term contains","schema":{"type":"string"},"example":"tornado"},{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":8,"query":"tornado","terms":[{"term":"Multiple Vortex Tornado","definition":"A tornado in which two or more condensation funnels or debris clouds are present at the same time, often rotating about a common center or about each other. Multiple-vortex tornadoes can be especially damaging."},{"term":"Tornado","definition":"A violently rotating column of air, usually pendant to a cumulonimbus, with circulation reaching the ground. It nearly always starts as a funnel cloud and may be accompanied by a loud roaring noise. On a local scale, it is the most destructive of all atmospheric phenomena."},{"term":"Tornado Emergency","definition":"An exceedingly rare tornado warning issued when there is a severe threat to human life and catastrophic damage from an imminent or ongoing tornado. This tornado warning is reserved for situations when a reliable source confirms a tornado, or there is clear radar evidence of the existence of a damaging tornado, such as the observation of debris."},{"term":"Tornado Family","definition":"A series of tornadoes produced by a single supercell, resulting in damage path segments along the same general line."},{"term":"Tornado Vortex Signature","definition":"An image of a tornado on the Doppler radar screen that shows up as a small region of rapidly changing wind speeds inside a mesocyclone. The following velocity criteria is normally required for recognition: velocity difference between maximum inbound and outbound (shear) is greater than or equal to 90 knots at less than 30 nmi and is greater than or equal to 70 knots between 30 and 55 nmi. It shows up as a red upside down triangle on the Storm Relative Velocity Display. Existence of a TVS strongly increases the probability of tornado occurrence, but does not guarantee it; therefore, the feature triggering it must be examined closely by the radar operator. A TVS is not a visually observable feature."},{"term":"Tornado Warning","definition":"This is issued when a tornado is indicated by the WSR-88D radar or sighted by spotters; therefore, people in the affected area should seek safe shelter immediately. They can be issued without a Tornado Watch being already in effect. They are usually issued for a duration of around 30 minutes. A Tornado Warning is issued by your local National Weather Service office (NWFO). It will include where the tornado was located and what towns will be in its path. If the tornado will affect the nearshore or coastal waters, it will be issued as the combined product--Tornado Warning and Special Marine Warning. If the thunderstorm which is causing the tornado is also producing torrential rains, this warning may also be combined with a Flash Flood Warning. If there is an ampersand (&) symbol at the bottom of the warning, it indicates that the warning was issued as a result of a severe weather report. After it has been issued, the affected NWFO will followed it up periodically with Severe Weather Statements. These statements will contain updated information on the tornado and they will also let the public know when warning is no longer in effect."},{"term":"Tornado Watch","definition":"This is issued by the National Weather Service when conditions are favorable for the development of tornadoes in and close to the watch area. Their size can vary depending on the weather situation. They are usually issued for a duration of 4 to 8 hours. They normally are issued well in advance of the actual occurrence of severe weather. During the watch, people should review tornado safety rules and be prepared to move a place of safety if threatening weather approaches. A Tornado Watch is issued by the Storm Prediction Center (SPC) in Norman, Oklahoma. Prior to the issuance of a Tornado Watch, SPC will usually contact the affected local National Weather Forecast Office (NWFO) and they will discuss what their current thinking is on the weather situation. Afterwards, SPC will issue a preliminary Tornado Watch and then the affected NWFO will then adjust the watch (adding or eliminating counties/parishes) and then issue it to the public. After adjusting the watch, the NWFO will let the public know which counties are included by way of a Watch Redefining Statement. During the watch, the NWFO will keep the public informed on what is happening in the watch area and also let the public know when the watch has expired or been cancelled."},{"term":"Wedge Tornado","definition":"Slang for a large tornado with a condensation funnel that is at least as wide (horizontally) at the ground as it is tall (vertically) from the ground to cloud base. The term \"wedge\" often is used somewhat loosely to describe any large tornado. However, not every large tornado is a wedge. A true wedge tornado, with a funnel at least as wide at the ground as it is tall, is very rare. Wedges often appear with violent tornadoes (F4 or F5 on the Fujita Scale), but many documented wedges have been rated lower. And some violent tornadoes may not appear as wedges (e.g., Xenia, OH on 3 April 1974, which was rated F5 but appeared only as a series of suction vortices without a central condensation funnel). Whether or not a tornado achieves \"wedge\" status depends on several factors other than intensity - in particular, the height of the environmental cloud base and the availability of moisture below cloud base. Therefore, spotters should not estimate wind speeds or F-scale ratings based on visual appearance alone. However, it generally is safe to assume that most (if not all) wedges have the potential to produce strong (F2/F3) or violent (F4/F5) damage."}],"total":8},"meta":{"timestamp":"2026-06-01T00:03:41.049Z","request_id":"9233a9be-f1ba-4951-a69a-87bd3e20ce9b"},"status":"ok","message":"Glossary 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/point":{"get":{"operationId":"get_v1_point","tags":["Reference"],"summary":"Location to NWS zone/office","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"},"example":"38.9"},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"string"},"example":"-77.0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"city":"Washington","point":"38.9,-77.0","radar":"KLWX","state":"DC","county":"DCC001","office":"LWX","timezone":"America/New_York","forecast_zone":"DCZ001","fire_weather_zone":"DCZ001"},"meta":{"timestamp":"2026-06-01T00:03:41.135Z","request_id":"0f4d28ce-3f7e-4669-9c10-8aa87c0bb39e"},"status":"ok","message":"Point 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/types":{"get":{"operationId":"get_v1_types","tags":["Reference"],"summary":"Alert event types","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":111,"event_types":["911 Telephone Outage","Administrative Message","Air Quality Alert","Air Stagnation Advisory","Ashfall Advisory","Ashfall Warning","Avalanche Advisory","Avalanche Warning","Avalanche Watch","Beach Hazards Statement","Blizzard Warning","Blowing Dust Advisory","Blowing Dust Warning","Blue Alert","Brisk Wind Advisory","Child Abduction Emergency","Civil Danger Warning","Civil Emergency Message","Coastal Flood Advisory","Coastal Flood Statement","Coastal Flood Warning","Coastal Flood Watch","Cold Weather Advisory","Dense Fog Advisory","Dense Smoke Advisory","Dust Advisory","Dust Storm Warning","Earthquake Warning","Evacuation Immediate","Extreme Heat Warning","Extreme Heat Watch","Extreme Cold Warning","Extreme Cold Watch","Extreme Fire Danger","Extreme Wind Warning","Fire Warning","Fire Weather Watch","Flash Flood Statement","Flash Flood Warning","Flash Flood Watch","Flood Advisory","Flood Statement","Flood Warning","Flood Watch","Freeze Warning","Freeze Watch","Freezing Fog Advisory","Freezing Spray Advisory","Frost Advisory","Gale Warning","Gale Watch","Hazardous Materials Warning","Hazardous Seas Warning","Hazardous Seas Watch","Hazardous Weather Outlook","Heat Advisory","Heavy Freezing Spray Warning","Heavy Freezing Spray Watch","High Surf Advisory","High Surf Warning","High Wind Warning","High Wind Watch","Hurricane Force Wind Warning","Hurricane Force Wind Watch","Hurricane Warning","Hurricane Watch","Hydrologic Outlook","Ice Storm Warning","Lake Effect Snow Warning","Lake Wind Advisory","Lakeshore Flood Advisory","Lakeshore Flood Statement","Lakeshore Flood Warning","Lakeshore Flood Watch","Law Enforcement Warning","Local Area Emergency","Low Water Advisory","Marine Weather Statement","Nuclear Power Plant Warning","Radiological Hazard Warning","Red Flag Warning","Rip Current Statement","Severe Thunderstorm Warning","Severe Thunderstorm Watch","Severe Weather Statement","Shelter In Place Warning","Short Term Forecast","Small Craft Advisory","Snow Squall Warning","Special Marine Warning","Special Weather Statement","Storm Surge Warning","Storm Surge Watch","Storm Warning","Storm Watch","Test","Tornado Warning","Tornado Watch","Tropical Cyclone Local Statement","Tropical Storm Warning","Tropical Storm Watch","Tsunami Advisory","Tsunami Warning","Tsunami Watch","Typhoon Warning","Typhoon Watch","Volcano Warning","Wind Advisory","Winter Storm Warning","Winter Storm Watch","Winter Weather Advisory"]},"meta":{"timestamp":"2026-06-01T00:03:41.222Z","request_id":"95f381fa-67ed-41d1-9bc5-40ffc6853e50"},"status":"ok","message":"Types 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/zone":{"get":{"operationId":"get_v1_zone","tags":["Reference"],"summary":"Forecast/county zone","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Zone id","schema":{"type":"string"},"example":"DCZ001"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"zone":{"id":"DCZ001","name":"District of Columbia","type":"public","radar":"LWX","state":"DC","offices":["LWX"],"timezone":"America/New_York"}},"meta":{"timestamp":"2026-06-01T00:03:41.289Z","request_id":"0564107a-b847-4355-8c98-fc210c6c75ea"},"status":"ok","message":"Zone 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":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live US weather alerts. /v1/alerts?area=TX (or point=lat,lon, or zone=TXZ211; filter severity=Extreme|Severe|Moderate|Minor, urgency=, event=Tornado Warning) = active warnings/watches/advisories with headline, description, instruction, effective/expires; /v1/count = how many alerts are active, by state; /v1/zone?id=DCZ001 = a forecast/county zone (name, state, office, timezone); /v1/point?lat=38.9&lon=-77.0 = a location's NWS office, forecast zone & county; /v1/types = the list of alert event types; /v1/glossary?term=tornado = NWS weather term definitions. Covers the United States. For forecasts use the Weather API; for airport METARs the METAR API.","source":"US National Weather Service (api.weather.gov)","endpoints":["/v1/alerts","/v1/count","/v1/zone","/v1/point","/v1/types","/v1/glossary","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:03:41.335Z","request_id":"f7d3c0e2-8d69-40af-a9da-f2533524d56c"},"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":3450,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":420,"monthly_call_quota":45000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1350,"monthly_call_quota":214000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3840,"monthly_call_quota":1070000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/weatheralerts-api"}