Endpoint: alerts

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), and MeteoAlarm.

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.

Use our wizard to try out this endpoint

If you are using a combination of the limit/skip parameters, note that you may be limited to a maximum skip value of 1000. In such cases, we recommend limiting the results further such as querying by country and/or state. For example: query=country:us,state:tx

Supported Alert Types

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.

Supported Actions

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 enpoint'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.

Supported Parameters

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.

Supported Filters

The following filters can be passed to the filter parameter to reduce the results that are returned:

county Some alerts such as Tornado warnings, severe thunderstorm warnings, flash flood warnings, flood warnings are issued county based, but include a small polygon of the coverage area within the county that is being affected. By default, if this small polygon exists, the API will only return the alert if the requested latitude/longitude is within the provided small polygon.

Using the filter=county option will make the API ignore any small polygon within the warning and return the warning based on the larger county coverage area.
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.
beach Returns beach-related alerts, such as rip current statements.
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.
canada Returns only Canadian alerts. Equivalent to query=country:ca
usa Returns only USA alerts. Equivalent to query=country:us
allcountries Returns alerts for all countries (the default).
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. Currently available for country level queries.
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.

Supported Query Properties

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;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;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)

Sortable Fields

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

Examples

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

Response

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.

Default
GeoJSON

{
    "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
        }
    }]
}
								

Response Properties

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.
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 allowed 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 fitler=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: October 22, 2020