The alerts endpoint (formerly known as the advisories endpoint) provides access to all currently active US, Canadian and European alerts as issued by the National Weather Service (NWS), Environment Canada (EC), MeteoAlarm, and the UK Met Office.
Both the NWS and EC issue a variety of weather warnings, watches, advisories, and statements. Within the USA, alerts are issued by either weather zone or county. Within Canada, alerts are issued by Canadian Location Codes.
Within Europe, MeteoAlarm issues weather alerts as warnings, with a severity indicator, moderate, severe, and extreme.
MeteoAlarm issues European alerts for today and tomorrow separately. The UK Met office issues alerts for today and the next 4 days. The AerisWeather API currently provides access for today’s alerts.
Use our wizard to try out this endpoint
Please refer to the full list of available alerts, type and color codes:
http://www.aerisweather.com/support/docs/aeris-maps/reference/alert-types/
The alert type codes may be passed in the type element of the query parameter and correspond to the details.type in the response output.
The following actions are supported with the alerts endpoint:
| :id | Requesting data by using the :id action is used for returning data for a particular item that has an ID associated with it. This is the primary method for requesting general weather information for a single location (observations, forecasts, advisories, etc.) as the location's name or a zip code serves as the id. Other endpoints may expect a certain value for the ID, such as storm cells whose ID value is a combination of the radar site identifier and unique identifier assigned to every storm cell. Refer to an endpoint's detailed documentation for specific information regarding how to use the :id action. |
| route | The route action returns data for points along a given route. This can be useful to obtain weather information along a transportation route, trails and more. The route is a series of locations, usually latitude/longitudes provided via the p query parameter or for longer routes via GeoJSON within a POST request. The route will return an array of GeoJSON points with the requested data for each point. |
The following parameters are optional unless otherwise noted:
| p | p=:place |
Defines the location to query data for. Refer to the list of supported place value formats. |
| limit | limit=:total |
The total number of results to return as an integer. Each endpoint may have a set maximum for this value depending on usage. The default limit is 1 if not specified. The maximum limit for this endpoint is 250. |
| filter | filter=:string |
Predefined filters for limiting the results. The filter value can be a single, comma-delimited or a semicolon delimited string of filter names. |
| query | query=:string |
Used to filter results based on certain fields in the data set. See Advanced Queries for more details. |
| sort | sort=:string |
Used to sort results based on certain fields in the data set. See Sorting for more details. |
| fields | fields=:string |
Provides a comma separated list of values for the API to return. This parameter is often used to limit the amount of data returned. See Reducing Output. |
| format | format=:string |
Defines the API output format. The available options include:format=json - Standard JSON output. This is the default.format=geojson - API will output GeoJSON.If obtaining GeoJSON and using the fields parameter, be sure to include loc to ensure geographical references are available in the response.
|
| lang | lang=:string |
Sets the language code to use for the API information, for endpoints that support this.lang=en - English. This is the default, if not provided.lang=fr - API will output in French.lang=es - API will output in Spanish.lang=it - API will output in Italian.
|
The following filters can be passed to the filter parameter to reduce the results that are returned:
| standard | (Default). Returns all alerts issued as a warning, watch, or advisory. Statements and outlooks are not returned by default, though available via the all filter or the individual alert type filters. |
| warning | Returns all warnings. A warning is issued when a hazardous weather or hydrologic event is occurring, imminent, or likely. A warning means weather conditions pose a threat to life or property. People in the path of the storm need to take protective action. |
| watch | Returns all watches. A watch is used when the risk of a hazardous weather or hydrologic event has increased significantly, but its occurrence, location, or timing is still uncertain. It is intended to provide enough lead time so those who need to set their plans in motion can do so. A watch means that hazardous weather is possible. People should have a plan of action in case a storm threatens and they should listen for later information and possible warnings especially when planning travel or outdoor activities. |
| advisory | Returns all alerts. An advisory is issued when a hazardous weather or hydrologic event is occurring, imminent, or likely. Advisories are for "less serious" conditions than warnings that may cause significant inconvenience, and if caution is not exercised could lead to situations that may threaten life or property. |
| outlook | Returns all outlooks. An outlook is issued daily to indicate that a hazardous weather or hydrologic event may occur in the next several days. The outlook will include information about potential severe thunderstorms, heavy rain or flooding, winter weather, extremes of heat or cold, etc., that may develop over the next 7 days with an emphasis on the first 24 hours of the forecast. It is intended to provide information to those who need considerable lead time to prepare for the event. |
| statement | Returns all special weather statements. This is typically used when the NWS needs to communicate a non-threatening message, but their message does not fall into the other categories (warning, advisory, outlook, etc.). |
| severe | Returns all severe-related alerts: - severe thunderstorm - tornado |
| flood | Returns all flood/hydro-related alerts: - debris flow - flood, flash flood - hydrologic |
| tropical | Returns all tropical-related alerts: - tropical storm, hurricane, typhoon - tropical storm wind - hurricane wind - extreme wind |
| winter | Returns all winter-related alerts: - blizzard, winter storm, winter weather - snow, heavy snow - lake effect snow - snow and blowing snow - ice pellets, freezing rain, ice storm - wind chill |
| marine | Returns all marine/coastal-related alerts: - marine - freezing spray, heavy freezing spray - small craft - small craft for winds - small craft for hazardous seas - small craft for rough bar - gale - hazardous seas - hurricane force winds - lakeshore flood - coastal flood, high surf - tsunami - low water - dense fog, dense smoke, ashfall (marine) |
| nonprecip | Returns all non-precipitation-related alerts: - blowing dust/dust storm - wind, high wind, lake wind - dense smoke - dense fog, freezing fog - freeze, frost - heat, excessive heat, extreme cold |
| forecast | Returns forecasts, normally short-term forecasts. |
| all | Return all warnings, watches, advisories, statements, outlooks and forecasts. |
| wind | Returns wind-related alerts. |
| fire | Returns fire-related alerts. |
| tsunami | Returns tsunami-related alerts. |
| now | Returns short term forecast alerts as defined by the National Weather Service. |
| synopsis | Returns a synopsis of the alerts. |
| tornado | Returns tornado related alerts (Tornado watches/warnings) |
| emergency | Returns emergency-specific alerts. |
| hassmallpoly | Returns alerts that have a small polygon (US severe thunderstorm, tornado, flash flood etc) |
| distinct | Returns only a single copy of a an alert issued for multiple locations. |
| nonmarine | Returns all warnings, watches, and advisories that are not marine related. |
| geo | Instructs the API to return the associated polygon with the alert output. Within the US, if the alert has a small polygon, this will be returned, otherwise the county or weather zone the alert was issued for will be returned. Within Canada the polygon will represent the Canadian Location Code (CLC) the alert is issued for. Within Europe the polygon will match the alert polygon as issued by MeteoAlarm. Please note, this feature will only work with a Premium subscription and reduces the maximum limit to 50 results due to the amount of data. |
Use the following supported property keys when creating custom queries for your requests:
| type | Used to query the alert type. The value should be set to the VTEC Code or the WMO if no VTEC code exists. Review the list of allowed Alert Types. Examples: /alerts/minneapolis,mn?query=type:TO.W will return only the tornado warnings/alerts/minneapolis,mn?query=type:TO.W;type:NOW will return tornado warnings and short-term forecasts |
| loc | Used to query by the zone id the alert is issued for. Normally will be a NOAA public weather zone that looks similar to VAZ014 or if issued for a specific county: VAC023. For Canadian alerts, the code will look similar to CLC-086420. |
| sig | Used to query by the one character coded significance of an alert type. W = Warning A = Watch Y = Advisory S = Statement O = Outlook F = Forecast Examples: /alerts/minneapolis,mn?query=sig:W;sig:A (returning alerts for Minneapolis, MN that are warnings or watches) |
| sigp | Used to query by the numeric representation of an alert type. A lower number has higher significance. 1 = Warning 3 = Watch 5 = Advisory 7 = Statement 9 = Forecast (Short term) 11 = Outlook Examples: /alerts/minneapolis,mn?query=sigp:1;sigp:3 (returns only warnings or watches for Minneapolis, MN) |
| name | County name or weather zone name (lowercase) of the location the alert has been issued for. |
| active | Used to query active or inactive alerts. 0 = not active 1 = active By default, the API will not return inactive alerts Examples: /alerts/minneapolis,mn?query=active:0:0 (returns only alerts that are no longer active for Minneapolis, MN) |
| emergency | Used to query emergency specific alerts, such as tornado emergencies. true = emergency specific alerts false = non emergency specific alerts |
| id | Used to query by an alert ID. |
| issued | Used to query alerts based on the issued time. Values can be relative formats or dates. Times are not currently supported. Examples: /alerts/minneapolis,mn?query=issued:-10minutes&limit=100 (returns alerts issued within the past 10 minutes for Minneapolis, MN) |
| begins | Used to query alerts based on the begins time of the alert. Some alerts such as winter storm warnings may be issued now, but do not go into effect until several hours later. Values can be relative formats or dates. Times are not currently supported. Examples: /alerts/minneapolis,mn?query=begins:-6hours:6hours&limit=100 (returns active alerts that either went into effect in the past six hours or are set to go live in the next 6 hours for Minneapolis, MN) |
| expires | Used to query alerts based on the expiration time. Values can be relative formats or dates. Times are not currently supported. Examples: /alerts/minneapolis,mn?query=expires:now:10minutes&limit=100 (returns alerts set to expire within the next 10 minutes for Minneapolis, MN) |
| added | Used to query alerts based on the time they were added to the API database. Values can be relative formats or dates. Times are not currently supported. Examples: /alerts/minneapolis,mn?query=added:-10minutes&limit=100 (returns alerts received and added within the last 10 minutes for Minneapolis, MN) |
Default Sort: emergency (desc), sigP (asc), issued (desc)
You can use the following fields to sort data. Review the sorting docs page for more information on the sort functionality.
| type | Used to sort by the alert type. |
| loc | Used to sort by the zone id the alert is issued for. Normally will be a NOAA public weather zone that looks similar to VAZ014 or if issued for a specific county: VAC023. For Canadian alerts, the code will look similar to CLC-086420. |
| sig | Used to sort by the one character coded significance of an alert type. W = Warning A = Watch Y = Advisory S = Statement O = Outlook F = Forecast |
| sigp | Used to query by the numeric representation of an alert type. A lower number has higher significance. 1 = Warning 3 = Watch 5 = Advisory 7 = Statement 9 = Forecast (Short term) 11 = Outlook |
| country | Used to sort by the two letter country abbreviation. |
| state | Sort by the two letter state abbreviation |
| name | Sort by the county name or weather zone name of the location the alert has been issued for. |
| active | Used to sort by active or inactive alerts. 0 = not active 1 = active By default, the API will not return inactive alerts |
| emergency | Used to sort by emergency specific alerts, such as tornado emergencies. true = emergency specific alerts false = non emergency specific alerts |
| id | Sort by the alert ID. |
| issued | Sort by the issued time of the alert |
| begins | Sort by the begins time of the alert |
| expires | Sort by the expiration time of the alert |
| added | Sort by the the time the alert was received and added to the database |
The /[:endpoint]/[:action]? portion within the query template below can be exchanged with any of the examples. Also, please note you will need to input your client credentials in the [ID] and [SECRET] fields which can be found under the Apps section of the members area.
https://api.aerisapi.com/[:endpoint]/[:action]?client_id=[ID]&client_secret=[SECRET]
Returns data for zip code 55403./alerts/55403?
Returns the alerts that affect the specified latitude/longitude./alerts/45.25,-95.25?
Return tornado warnings affecting zip code 55403/alerts/?p=55403&query=type:TO.W&
Return flood related alerts affecting Minneapolis,MN/alerts/minneapolis,mn?filter=flood
The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.
{
"success": true,
"error": null,
"response": [{
"id": "7751ec729930c9b5c6787ab6c532482c",
"loc": {
"long": -103.223027968,
"lat": 44.0006520001
},
"details": {
"type": "FF.A",
"name": "FLASH FLOOD WATCH",
"loc": "SDZ026",
"emergency": false,
"color": "32CD32",
"cat": "flood",
"body": "...LOCALLY HEAVY RAINFALL POSSIBLE THROUGH EVENING...\n\n.Scattered showers and thunderstorms will continue through this \nevening. Some of the storms could produce locally heavy rainfall \non already saturated ground, resulting in flash flooding.\n\n\n...FLASH FLOOD WATCH REMAINS IN EFFECT UNTIL MIDNIGHT MDT\nTONIGHT...\n\nThe Flash Flood Watch continues for\n\n* Portions of South Dakota and the Black Hills of Wyoming, \nincluding the following areas, in South Dakota, the Central \nBlack Hills, the Hermosa Foot Hills, the Northern Black Hills, \nthe Northern Foot Hills, the Rapid City area, the Southern \nBlack Hills, the Southern Foot Hills, and the Sturgis\/Piedmont \nFoot Hills. In the Black Hills of Wyoming, the Wyoming Black \nHills. \n\n* Until midnight MDT tonight\n\n* Scattered showers and thunderstorms will continue through this\nevening. Locally heavy rain is possible, especially through \nearly this evening. \n\n* Local rainfall amounts of more than an inch are possible in a \nshort period of time, which combined with the already \nsaturated ground, may result in flash flooding. \n\nA flash flood watch means that conditions are favorable for heavy\nrain over the watch area, which may cause flash flooding along\nstreams, creeks, canyons, and draws. If you are in the watch\narea, monitor noaa weather radio and local media for updated\nforecasts. Be ready to quickly move to higher ground, if heavy\nrain occurs, rising water levels are observed, or a warning is\nissued.",
"bodyFull": "WGUS63 KUNR 291958\nFFAUNR\n\nFlood Watch\nNational Weather Service Rapid City SD\n158 PM MDT Tue May 29 2018\n\n...LOCALLY HEAVY RAINFALL POSSIBLE THROUGH EVENING...\n\n.Scattered showers and thunderstorms will continue through this \nevening. Some of the storms could produce locally heavy rainfall \non already saturated ground, resulting in flash flooding.\n\nSDZ024>029-072-074-WYZ057-300600-\n\/O.CON.KUNR.FF.A.0003.000000T0000Z-180530T0600Z\/\n\/00000.0.ER.000000T0000Z.000000T0000Z.000000T0000Z.OO\/\nNorthern Black Hills-Northern Foot Hills-Rapid City-\nSouthern Foot Hills-Central Black Hills-Southern Black Hills-\nSturgis\/Piedmont Foot Hills-Hermosa Foot Hills-\nWyoming Black Hills-\nIncluding the cities of Lead, Deadwood, Spearfish, Rapid City, \nEdgemont, Hot Springs, Hill City, Mt Rushmore, Custer, Sturgis, \nHermosa, Four Corners, and Sundance\n158 PM MDT Tue May 29 2018\n\n\n\n...FLASH FLOOD WATCH REMAINS IN EFFECT UNTIL MIDNIGHT MDT\nTONIGHT...\n\nThe Flash Flood Watch continues for\n\n* Portions of South Dakota and the Black Hills of Wyoming, \nincluding the following areas, in South Dakota, the Central \nBlack Hills, the Hermosa Foot Hills, the Northern Black Hills, \nthe Northern Foot Hills, the Rapid City area, the Southern \nBlack Hills, the Southern Foot Hills, and the Sturgis\/Piedmont \nFoot Hills. In the Black Hills of Wyoming, the Wyoming Black \nHills. \n\n* Until midnight MDT tonight\n\n* Scattered showers and thunderstorms will continue through this\nevening. Locally heavy rain is possible, especially through \nearly this evening. \n\n* Local rainfall amounts of more than an inch are possible in a \nshort period of time, which combined with the already \nsaturated ground, may result in flash flooding. \n\nPRECAUTIONARY\/PREPAREDNESS ACTIONS...\n\nA flash flood watch means that conditions are favorable for heavy\nrain over the watch area, which may cause flash flooding along\nstreams, creeks, canyons, and draws. If you are in the watch\narea, monitor noaa weather radio and local media for updated\nforecasts. Be ready to quickly move to higher ground, if heavy\nrain occurs, rising water levels are observed, or a warning is\nissued.\n\n&&"
},
"timestamps": {
"issued": 1527623880,
"issuedISO": "2018-05-29T13:58:00-06:00",
"begins": 1527623880,
"beginsISO": "2018-05-29T13:58:00-06:00",
"expires": 1527660000,
"expiresISO": "2018-05-30T00:00:00-06:00",
"added": 1527623935,
"addedISO": "2018-05-29T13:58:55-06:00"
},
"poly": "",
"geoPoly": null,
"includes": {
"counties": [],
"fips": ["46033", "46047", "46081", "46093", "46103", "56011", "56045"],
"wxzones": ["SDZ024", "SDZ025", "SDZ026", "SDZ027", "SDZ028", "SDZ029", "SDZ072", "SDZ074", "WYZ057"],
"zipcodes": [57626, 57701, 57702, 57703, 57706, 57709, 57718, 57719, 57722, 57725, 57730, 57732, 57735, 57737, 57738, 57741, 57744, 57745, 57747, 57748, 57751, 57754, 57758, 57759, 57761, 57763, 57766, 57767, 57769, 57773, 57775, 57779, 57780, 57782, 57783, 57785, 57787, 57790, 57791, 57792, 57793, 57799, 82701, 82710, 82711, 82712, 82714, 82715, 82720, 82721, 82723, 82729, 82730]
},
"place": {
"name": "rapid city",
"state": "sd",
"country": "us"
},
"profile": {
"tz": "America\/Denver"
},
"active": true
}]
}
{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[-104.05, 43],
[-104.05, 43.48],
[-103.73, 43.48],
[-103.69, 43.34],
[-103.51, 43.31],
[-103.29, 43.3],
[-103.18, 43.16],
[-103.24, 43],
[-104.05, 43]
]
]
},
"properties": {
"id": "edcbd2bcfb57c15473eb79b781959a1d",
"loc": {
"long": -103.527544076,
"lat": 43.2393902679
},
"details": {
"type": "FA.W",
"name": "FLOOD WARNING",
"loc": "SDC047",
"emergency": false,
"color": "00FF00",
"cat": "flood",
"body": "...A FLOOD WARNING REMAINS IN EFFECT UNTIL NOON MDT THURSDAY FOR FALL\nRIVER COUNTY...\n\nAt 1233 PM MDT, emergency management and the Fall River County \nHighway department reported flooding across southern Fall River \nCounty. Over the past few days, over three inches of rain has \nfallen. Runoff from this heavy rain has flooded a few county roads \nincluding portions of Black Banks Road, Hard Scrabble Road and \nEdgemont Road. \n\nAdditional rainfall is expected today and tonight. \n\nThis flood warning includes the following streams and \ndrainages...Beef Creek... Black Banks Creek...Cottonwood Creek...Hat \nCreek...Plum Creek...Duck Creek...Alkali Creek...Little Cottonwood \nCreek...Dry Creek...Horsehead Creek and tributaries into Hat Creek, \nHorsehead Creek, and the Cheyenne River upstream of Angostura \nReservoir.\n\nTurn around, don't drown when encountering flooded roads. Most flood \ndeaths occur in vehicles. Also, river banks and culverts can become \nunstable and unsafe with high water.",
"bodyFull": "WGUS83 KUNR 291835\nFLSUNR\n\nFlood Statement\nNational Weather Service Rapid City SD\n1235 PM MDT TUE MAY 29 2018\n\n\n\nSDC047-311800-\n\/O.CON.KUNR.FA.W.0004.000000T0000Z-180531T1800Z\/\n\/00000.0.ER.000000T0000Z.000000T0000Z.000000T0000Z.OO\/\nFall River SD-\n1235 PM MDT TUE MAY 29 2018\n\n\n\n...A FLOOD WARNING REMAINS IN EFFECT UNTIL NOON MDT THURSDAY FOR FALL\nRIVER COUNTY...\n\nAt 1233 PM MDT, emergency management and the Fall River County \nHighway department reported flooding across southern Fall River \nCounty. Over the past few days, over three inches of rain has \nfallen. Runoff from this heavy rain has flooded a few county roads \nincluding portions of Black Banks Road, Hard Scrabble Road and \nEdgemont Road. \n\nAdditional rainfall is expected today and tonight. \n\nThis flood warning includes the following streams and \ndrainages...Beef Creek... Black Banks Creek...Cottonwood Creek...Hat \nCreek...Plum Creek...Duck Creek...Alkali Creek...Little Cottonwood \nCreek...Dry Creek...Horsehead Creek and tributaries into Hat Creek, \nHorsehead Creek, and the Cheyenne River upstream of Angostura \nReservoir.\n\nPRECAUTIONARY\/PREPAREDNESS ACTIONS...\n\nTurn around, don't drown when encountering flooded roads. Most flood \ndeaths occur in vehicles. Also, river banks and culverts can become \nunstable and unsafe with high water.\n\n&&\n\nLAT...LON 4300 10405 4348 10405 4348 10373 4334 10369\n4331 10351 4330 10329 4316 10318 4300 10324"
},
"timestamps": {
"issued": 1527618900,
"issuedISO": "2018-05-29T12:35:00-06:00",
"begins": 1527618900,
"beginsISO": "2018-05-29T12:35:00-06:00",
"expires": 1527789600,
"expiresISO": "2018-05-31T12:00:00-06:00",
"added": 1527618929,
"addedISO": "2018-05-29T12:35:29-06:00"
},
"poly": "-104.05,43,-104.05,43.48,-103.73,43.48,-103.69,43.34,-103.51,43.31,-103.29,43.3,-103.18,43.16,-103.24,43",
"geoPoly": {
"type": "Polygon",
"coordinates": [
[
[-104.05, 43],
[-104.05, 43.48],
[-103.73, 43.48],
[-103.69, 43.34],
[-103.51, 43.31],
[-103.29, 43.3],
[-103.18, 43.16],
[-103.24, 43],
[-104.05, 43]
]
]
},
"includes": {
"counties": ["SDC047"],
"fips": ["46047"],
"wxzones": ["SDZ027", "SDZ041"],
"zipcodes": [57735, 57763]
},
"place": {
"name": "fall river",
"state": "sd",
"country": "us",
"county": "047"
},
"profile": {
"tz": "America\/Denver"
},
"active": true
}
}]
}
The following properties will be provided in every response object:
| id | (string) The unique ID attribute identifying the alert. The ID is based on a combination of the details.loc, details.type and an internal event ID. Normally, the same ID will be utilized if the weather offices update the alert. |
| dataSource | (string) The source of the official alert information. Potential values include: - noaa_nws - envca - meteoalarm - ukmet |
| loc | (object) The object containing the latitude/longitude of the alert centroid. In some instances, such as high seas alerts, the loc may be unavailable and returned as Null. |
| loc.latitude | (number) The latitude of the weather zone or county centroid |
| loc.longitude | (number) The longitude of the weather zone or county centroid |
| details | (object) The object containing the alert details |
| details.type | (string) The valid-time event code (VTEC) for the alert. Review the list of supported Alert Types. |
| details.name | (string) The type name for the alert. |
| details.loc | (string) The weather zone for the alert. |
| details.emergency | (boolean) Set to true if this is an emergency-specific alert, such as a tornado emergency. |
| details.priority | (number) The numeric priority of the alert. The lower the priority the higher the alert significance. Will typically match the NOAA defined alert priorities. There may be some minor differences from the NOAA list, especially for international locations. If a location has multiple active alerts, the API will normally sort based on priority ascending, so the alert with the most significant is first. |
| details.color | (string) The 6 character hex color code for the alert. Corresponds to the AMP Alert types/colors. |
| details.cat | (string) The default category of the alert type. May be null for non common alerts. |
| details.body | (string) The shortened and formatted version of the alert body text. Primarily for US alerts, removing the National Weather Service alert header information. Often the same as the bodyFull for Canadian and European alerts. |
| details.bodyFull | (string) The complete, unmodified version of the alert body text, including headers. |
| timestamps.issued | (number) UNIX timestamp when the alert was initially issued for the location. This value will not normally change during the lifetime of the alert. |
| timestamps.issuedISO | (string) ISO 8601 date of the time when the initially issued for the location. This value will not normally change during the lifetime of the alert. |
| timestamps.updated | (number) UNIX timestamp when the alert was updated. For a new alert, the issue and updated will normally match. If an alert is updated during its lifetime, this updated timestamp will change. |
| timestamps.updatedISO | (number) ISO 8601 date of when the alert was updated. For a new alert, issue and updated will normally match. If an alert is updated during its lifetime, this updated timestamp will change. |
| timestamps.begins | (number) UNIX timestamp when the alert goes into effect. Often this will match the issue/updated time, though for some alerts, such as winter storm warnings, this may be set to a future date/time. |
| timestamps.beginsISO | (string) ISO 8601 date of the time when the alert goes into effect. Often this will match the issue/updated time, though for some alerts, such as winter storm warnings, this may be set to a future date/time. |
| timestamps.expires | (number) UNIX timestamp when the alert expires. |
| timestamps.expiresISO | (string) ISO 8601 date of the time when the alert expires. |
| timestamps.added | (number) UNIX timestamp when the issuance or last update for the alert was received and stored in the DB after initial issuance. |
| timestamps.addedISO | (string) ISO 8601 date when the issuance or last update for the alert was received and stored in the DB after initial issuance. |
| poly | (string) DEPRECATED. A comma-delimited string of latitude, longitude coordinates defining the small polygon boundary for this alert; typically used for certain alerts, such as tornado and severe thunderstorm warnings. NULL if the alert does not include a small polygon boundary. This field has been deprecated in favor of the geoPoly attribute. |
| geoPoly | (object) A GeoJSON polygon defining the small polygon boundary for this alert; typically used for certain alerts, such as tornado and severe thunderstorm warnings. NULL if the alert does not include a small polygon boundary. When filter=geo is utilized, if no small polygon exists for the alert, the polygon for the weather zone, fire zone, county or CLC they alert is issued for will be returned. |
| includes.counties | (array) If a US alert will be a list of US counties in the XXC### format, where XX is the state abbreviation and ### is the 3 digit county fips number. If a Canadian alert will be null. |
| includes.fips | (array) If a US alert will be a list of US counties in the XX### format, where XX is the state two digit fips number and ### is the 3 digit county fips number. If a Canadian alert will be null. |
| includes.wxzones | (array) If a US alert will be a list of US public weather zones in the NOAA XXZ### format, where XX is the state abbreviation and ### is the 3 digit public zone id. If a Canadian alert will be a list of Canadian location codes (CLCs) |
| includes.zipcodes | (array) List of US zip codes that are affected by the alert. Only US zip codes, where the zip code centroid are within the alert, including any small polygon will be returned. |
| place.county | (string) The FIPS code of the county in which the alert is located. |
| place.name | (string) The place or nearest place to the record. |
| place.state | (string) The state abbreviation in which the record is located. This may be null depending on the country. |
| place.country | (string) The country abbreviation in which the record is located. |
| profile.tz | (string) The timezone name association with the record's location. |
Last modified: December 14, 2022