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)
  • &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=39.75895&lon=-84.19161&key=API_KEY

Example Response (JSON):


          {
             "country_code":"US",
             "lon":-84.19161,
             "timezone":"America\/New_York",
             "lat":39.75895,
             "alerts":[
                {
                   "regions":[
                      "Madison",
                      " Franklin",
                      " Scioto",
                      " Hardin",
                      " Logan",
                      " Licking",
                      " Montgomery",
                      " Clermont",
                      " Fayette",
                      " Brown",
                      " Mercer",
                      " Wayne",
                      " Adams",
                      " Union",
                      " Warren",
                      " Highland",
                      " Lewis",
                      " Ross",
                      " Robertson",
                      " Clark",
                      " Fayette",
                      " Preble",
                      " Shelby",
                      " Clinton",
                      " Franklin",
                      " Pike",
                      " Miami",
                      " Delaware",
                      " Bracken",
                      " Greene",
                      " Auglaize",
                      " Hocking",
                      " Fairfield",
                      " Butler",
                      " Champaign",
                      " Pickaway",
                      " Darke",
                      " Mason",
                      " Union"
                   ],
                   "ends_utc":"2020-10-17T13:00:00",
                   "effective_local":"2020-10-16T14:17:00",
                   "onset_utc":"2020-10-17T06:00:00",
                   "expires_local":"2020-10-16T22:30:00",
                   "expires_utc":"2020-10-17T02:30:00",
                   "ends_local":"2020-10-17T09:00:00",
                   "uri":"https:\/\/api.weather.gov\/alerts\/NWS-IDP-PROD-4486346-3727122",
                   "onset_local":"2020-10-17T02:00:00",
                   "effective_utc":"2020-10-16T18:17:00",
                   "severity":"Watch",
                   "title":"Freeze Warning issued October 16 at 2:17PM EDT until October 17 at 9:00AM EDT by NWS Wilmington OH",
                   "description":"* WHAT...Sub-freezing temperatures as low as 30 expected.\n\n* WHERE...Portions of East Central and Southeast Indiana,\nNortheast and Northern Kentucky and Central, South Central,\nSouthwest and West Central Ohio.\n\n* WHEN...From 2 AM to 9 AM EDT Saturday.\n\n* IMPACTS...Frost and freeze conditions will kill crops, other\nsensitive vegetation and possibly damage unprotected outdoor\nplumbing."
                }
             ],
             "city_name":"Dayton",
             "state_code":"OH"
          }
        

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.
  • ]