Severe Weather Alerts API

This API returns severe weather alerts issued by local meteorological agencies. Current supported countries include: The USA via NOAA. As well as European Union member nations, and Isreal via Meteoalarm.

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.
callback=[function] (optional: JSON-P callback)

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)
  • &city=Raleigh&country=US
  • &city=Raleigh,NC
  • &city=Raleigh,North+Carolina
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=38.00&lon=-90.00&key=API_KEY

Example Response (JSON):


        {  
           "lat":38.01,
           "lon":-90.01,
           "timezone":"America\/Chicago",
           "city_name":"Sainte Genevieve",
           "state_code":"MO",
           "country_code":"US",
           "alerts":[  
              {  
                 "title":"Winter Weather Advisory issued February 9 at 3:17AM CST expiring February 10 at 12:00PM CST by NWS St Louis MO",
                 "description":"* WHAT...Mixed precipitation expected. Total snow and sleet\naccumulations of less than one inch, and ice accumulations of\nup to one tenth of an inch expected.\n\n* WHERE...Portions of east central and southeast Missouri and\nsouthwest Illinois.\n\n* WHEN...From midnight tonight to noon CST Sunday.\n\n* ADDITIONAL DETAILS...Plan on slippery road conditions.",
                 "severity":"Advisory",
                 "effective_utc":"2019-02-09T09:17:00",
                 "effective_local":"2019-02-09T04:17:00",
                 "expires_local":"2019-02-09T18:00:00",
                 "expires_utc":"2019-02-09T23:00:00",
                 "uri":"https:\/\/api.weather.gov\/alerts\/NWS-IDP-PROD-3362405-2942405",
                 "regions":[  
                    "St. Francois",
                    "Reynolds",
                    "Randolph",
                    "Ste. Genevieve",
                    "Washington",
                    "Crawford",
                    "Madison",
                    "Iron"
                 ]
              },
              {                   
                 "title":"Flood Warning issued February 8 at 8:51PM CST expiring February 12 at 8:24AM CST by NWS St Louis MO",
                 "description":"Mississippi River at Chester\n\n.This Flood Warning is a result of 1-2 inches of rainfall across\nthe basin earlier this week...\nThe Flood Warning continues for\nthe Mississippi River at Chester\n* until Tuesday morning.\n* At  8:30 PM Friday the stage was 26.8 feet.\n* Flood stage is 27.0 feet.\n* Minor flooding is forecast.\n* The river is forecast to rise above flood stage by tonight and to\ncrest near 29.0 feet by Saturday evening. The river is forecast to\nfall below flood stage by Monday morning.\n* Impact:  At 28.0 feet...Unleveed islands near Chester and the prison\nfarm floods.\n* Impact:  At 27.0 feet...Flood Stage.  Unprotected farmland on right\nbank begins to flood.",
                 "severity":"Warning",
                 "effective_utc":"2019-02-09T02:51:00",
                 "effective_local":"2019-02-08T21:51:00",
                 "expires_utc":"2019-02-10T02:51:00",
                 "expires_local":"2019-02-09T21:51:00",
                 "uri":"https:\/\/api.weather.gov\/alerts\/NWS-IDP-PROD-3361975-2942026",
                 "regions":[  
                    "Randolph, IL",
                    "Jackson, IL",
                    "Ste. Genevieve, MO",
                    "Perry, MO"
                 ]
              }
           ]
        }
        

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.
    • uri: An HTTP(S) URI that one may refer to for more detailed alert information.
    • regions: An array of affected regions.
  • ]