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