Severe Weather Alerts API
This API returns severe weather alerts issued by local meteorological agencies. Current supported countries include: The USA via NOAA. European Union member nations, the United Kingdom, and Israel via Meteoalarm. As well as weather alerts for Canada via Environment Canada, and China via the China Meteorological Administration.
Note: Alerts are typically issued in the language of the local country.
Base URL
HTTP: http://api.weatherbit.io/v2.0/alerts
HTTPS: https://api.weatherbit.io/v2.0/alerts
Supported Methods: GET
Request Parameters
key=[key] (REQUIRED)
key- Your API Key.
API Endpoints
| Description | Required Parameters | Example(s) |
|---|---|---|
| Get alerts by lat/lon | lat,lon | &lat=38.123&lon=-78.543 |
| Get alerts by city name | city, state(optional), country (optional) |
|
| Get alerts by postal code | postal_code, country (optional) | &postal_code=27601&country=US |
| Get alerts by city id | city_id | &city_id=8953360 |
Example Request:
https://api.weatherbit.io/v2.0/alerts?lat=28.5384&lon=-81.3789&key=API_KEYExample Response (JSON): [Download]
{
"alerts":[
{
"description":"* WHAT...Flooding caused by excessive rainfall is expected.\n\n* WHERE...A portion of east central Florida, including the following\ncounties, Lake, Orange and Seminole.\n\n* WHEN...Until 615 PM EDT.\n\n* IMPACTS...Minor flooding in low-lying and poor drainage areas.\n\n* ADDITIONAL DETAILS...\n- At 419 PM EDT, Doppler radar indicated heavy rain due to\nthunderstorms. Minor flooding is ongoing or expected to begin\nshortly in the advisory area. Between 1.5 and 3 inches of\nrain have fallen.\n- Additional rainfall amounts of 1 to 2 inches are expected\nover the area. This additional rain will result in minor\nflooding.\n- Some locations that will experience flooding include...\nOrlando, Sanford, Apopka, Altamonte Springs, Winter Springs,\nCasselberry, Maitland, Lake Mary, Longwood, Lockhart, Mount\nPlymouth, Cassia, Zellwood, Pine Hills, Wekiwa Springs State\nPark, Wekiva Springs, Forest City, Fern Park, Sorrento and\nFairview Shores.\n- http://www.weather.gov/safety/flood",
"effective_local":"2024-08-22T16:19:00",
"effective_utc":"2024-08-22T20:19:00",
"ends_local":"2024-08-22T18:15:00",
"ends_utc":"2024-08-22T22:15:00",
"expires_local":"2024-08-22T18:15:00",
"expires_utc":"2024-08-22T22:15:00",
"onset_local":"2024-08-22T16:19:00",
"onset_utc":"2024-08-22T20:19:00",
"regions":[
"Lake, FL",
" Orange, FL",
" Seminole, FL"
],
"severity":"Advisory",
"title":"Flood Advisory issued August 22 at 4:19PM EDT until August 22 at 6:15PM EDT by NWS Melbourne FL",
"uri":"https://api.weather.gov/alerts/urn:oid:2.49.0.1.840.0.9079ecdac4135d19817f4fd0647a7493256e5c34.001.1"
}
],
"city_name":"Orlando",
"country_code":"US",
"lat":28.5384,
"lon":-81.3789,
"state_code":"FL",
"timezone":"America/New_York"
}
Field Decriptions:
lat:Latitude (Degrees).lon:Longitude (Degrees).timezone:Local IANA Timezone.city_name:Nearest city name.state_code:State abbreviation/code.country_code:Country abbreviation.alerts: [title:Brief description of the alert.description:Detailed description of the alert.severity:Severity of the weather phenomena - Either "Advisory", "Watch", or "Warning".effective_utc:UTC time that alert was issued.effective_local:Local time that alert was issued.expires_utc:UTC time that alert expires.expires_local:Local time that alert expires.onset_utc:UTC time that alert event starts (If available).onset_local:Local time that alert event starts (If available).ends_utc:UTC time that alert event ends (If available).ends_local:Local time that alert event ends (If available).uri:An HTTP(S) URI that one may refer to for more detailed alert information.regions:An array of affected regions.]