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, and Israel via Meteoalarm. As well as Canadian alerts via Environment Canada.
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=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.]