Endpoint: alerts

The alerts endpoint (formerly known as the advisories endpoint) provides access to all currently active US and Canadian alerts as issued by the National Weather Service (NWS) and Environment Canada (EC). 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.

https://api.aerisapi.com/alerts/

Data CoverageUSA, Canada

Included With API Developer,  API Basic,  API Premium

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.
within The within action allows for returning data within a variety of different geometrical regions. Currently supported geometries include a circle (requires a center point and radius), square (requires two coordinate points defining the top-left and bottom-right corners) and polygon (requires at least three coordinate points). Unlike the closest action, the results will not be returned in any particular order based on distance.
closest The closest action will query the API for data that is closest to the requested place and return the results, if any, in order from closest to farthest. If no limit is provided in the request, then only the closest single result will be returned.

If your request does not return results, you may try setting or increasing the radius being used.
search The search action is used as a more general query method and expects the query to be defined with the custom query for the request. Unlike the closest action, results will not be returned in any particular order.

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.
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.
radius radius=:distance:unit When requesting the closest results within a circle, the radius determines how far from the specified location to search. A valid unit value must be included in your radius value, e.g., "5mi", "10km", "25miles". If no unit is provided, your value is assumed to be in meters by default.

Most endpoints utilize a default radius of 50 miles, though some endpoints, such as lightning, may have tighter restrictions specified.
sort sort=:string Used to sort results based on certain fields in the data set. See Sorting for more details.
callback callback=:functionName Used with JSONP implementation.

Defines the callback function to use for the response. The response will be enclosed as C(response), where C is the callback function provided.
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.
skip skip=:number Used to skip over a specific number of results in the data set.
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


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.
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 alerts that are currently in effect.
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.

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;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:3 (returns only warnings and watches for Minneapolis, MN)
country Two letter country abbreviation (lowercase) of the location the alert was issued for. (US and Canada only)
state Used to query by state, useful for requesting all alerts for a specific state. Two letter, lower case state abbreviation.
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

You can use the following fields to sort the data returned in your response:

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


Examples:
/alerts/search?filter=usa&sort=emergency:-1 (returns the alerts within the use with any emergency alerts first)
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 alerts currently affecting Toronto, Canada.
/alerts/toronto,on,ca?

Return alerts for zip code 55403, ignoring any small polygons. If a severe thunderstorm or tornado warning is issued for anywhere in the same county, it will be returned.
/alerts/55403?filter=county&

Returns the alerts that affect the specified latitude/longitude.
/alerts/45.25,-95.25?

Returns an array of alert objects, sorted by distances, closest to furthest. “distance” value is included in each alert object.
/alerts/closest?p=45.25,-95.25&

Return closest/nearby alerts to the specified point.
/alerts/closest?p=45.25,-95.25&

Return up to 5 alerts within 50 miles of zip code 55403 (Minneapolis). Results will be sorted by distance (ascending) from zip code 55403.
/alerts/closest?p=55403&limit=5&radius=50mi&

Return up to one tornado warning within 50 miles of zip code 55403.
/alerts/closest?p=55403&query=type:TO.W&

Return all tornado warnings within 50 miles of zip code 55403. Results will be sorted by distance.
/alerts/closest?p=55403&query=TO.W&limit=0&

Returns all alerts within a rectangle defined by the coordinates specified in the point parameter. The points should be: top latitude, left longitude, bottom latitude, right longitude.
/alerts/within?p=:top,:left,:bottom,:right
/alerts/within?p=45.25,-95.25,35.25,-85.25&

Returns all alerts within a circle with its center at the specified latitude/longitude point and a radius distance from that center.
NOTE: This functionality is similar to the closest search, but does not include a distance or sorting. It is a faster query.
/alerts/within?p=:lat,:lon&radius=:distance
/alerts/within?p=44,-93&radius=25miles&

Returns all alerts within a polygon specified by a series of comma-separated latitude, longitude points. There must be three or more points specified.
/alerts/within?p=:lat1,:lon1,:lat2,:lon2,:lat3,:lon3...
/alerts/within?p=30.69,-86.04,33.19,-84.31,29.90,-82.05&

Return up to 10 alerts within the rectangle specified with the top-left corner at 45.25, -95.25 and the bottom-right corner at 35.25, -85.25.
/alerts/within?p=45.25,-95.25,35.25,-85.25&limit=10&

Return all tornado warnings within the rectangle specified with the top-left corner at 45.25, -95.25 and the bottom-right corner at 35.25, -85.25.
/alerts/within?p=45.25,-95.25,35.25,-85.25&query=type:TO.W&

Return all severe and wind-related alerts within the rectangle specified with the top-left corner at 45.25, -95.25 and the bottom-right corner at 35.25, -85.25.
/alerts/within?p=45.25,-95.25,35.25,-85.25&filter=severe;wind&

Returns all alerts within a circle with a center at zip code 55403 (Minneapolis) and a radius of 50 miles (the default).
NOTE: This functionality is similar to the closest search, thus you can pass radius as needed.
/alerts/within?p=55403&

Return all tornado warnings.
/alerts/search?query=type:TO.W&

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

{
   "id":"4f040eedfd58153800598f59c39c44f9",
   "loc":{
      "long":-84.76328,
      "lat":33.35346
   },
   "details":{
      "type":"FF.A",
      "name":"FLASH FLOOD WATCH",
      "loc":"GAZ053",
      "emergency":false,
      "color":"32CD32",
      "cat":"flood",
      "body":"...FLASH FLOOD WATCH IN EFFECT THROUGH WEDNESDAY MORNING...\n\nThe National Weather Service in Peachtree City has issued a\n\n* Flash Flood Watch for portions of central Georgia...east \ncentral Georgia...north central Georgia...northeast Georgia... \nnorthwest Georgia and west central Georgia...including the \nfollowing areas...in central Georgia...Baldwin...Butts... \nJasper...Jones...Monroe and Putnam. In east central Georgia... \nGreene...Hancock...Taliaferro...Warren and Wilkes. In north \ncentral Georgia...Barrow...Clayton...Cobb...DeKalb...Douglas...\nFayette...Gwinnett...Henry...Morgan...Newton...North Fulton...\nRockdale...South Fulton and Walton. In northeast Georgia... \nClarke...Jackson...Madison...Oconee and Oglethorpe. In \nnorthwest Georgia...Carroll...Haralson and Paulding. In west \ncentral Georgia...Coweta...Harris...Heard...Lamar... \nMeriwether...Pike...Spalding...Talbot...Troup and Upson. \n\n* Through Wednesday morning\n\n* A weak frontal boundary will remain stationary across west\ncentral Georgia through the Atlanta Metro to near Athens through\ntonight. Heavy rainfall occurred along the Interstate 20 \ncorridor Monday night\/early Tuesday morning with widespread \nvalues between one and three inches, with some spotty 4 to 6 \ninches. An additional one to three inches with locally higher \namounts is possible through the day Tuesday and into the \novernight hours. \n\n* Flooding in low lying and flood prone areas will be possible,\nespecially in urban areas along the Interstate 20 corridor. In \naddition, creeks, streams and rivers may overflow their banks.\n\nA Flash Flood Watch means that conditions may develop that lead\nto flash flooding. Flash flooding is a very dangerous situation.\n\nYou should monitor later forecasts and be prepared to take action\nshould Flash Flood Warnings be issued.",
      "bodyFull":"WGUS62 KFFC 200719\nFFAFFC\n\nURGENT - IMMEDIATE BROADCAST REQUESTED\nFlood Watch\nNational Weather Service Peachtree City GA\n319 AM EDT Tue Jun 20 2017\n\n\n\nGAZ025-027-031>039-041>062-066>073-078-079-201530-\n\/O.NEW.KFFC.FF.A.0006.170620T0719Z-170621T1200Z\/\n\/00000.0.ER.000000T0000Z.000000T0000Z.000000T0000Z.OO\/\nJackson-Madison-Paulding-Cobb-North Fulton-Gwinnett-Barrow-Clarke-\nOconee-Oglethorpe-Wilkes-Haralson-Carroll-Douglas-South Fulton-\nDeKalb-Rockdale-Walton-Newton-Morgan-Greene-Taliaferro-Heard-\nCoweta-Fayette-Clayton-Spalding-Henry-Butts-Jasper-Putnam-Hancock-\nWarren-Troup-Meriwether-Pike-Upson-Lamar-Monroe-Jones-Baldwin-\nHarris-Talbot-\nIncluding the cities of Marietta, Atlanta, Lawrenceville, Athens,\nCarrollton, Douglasville, East Point, Decatur, Conyers, \nCovington, Newnan, Peachtree City, Griffin, and Milledgeville\n319 AM EDT Tue Jun 20 2017\n\n\n\n...FLASH FLOOD WATCH IN EFFECT THROUGH WEDNESDAY MORNING...\n\nThe National Weather Service in Peachtree City has issued a\n\n* Flash Flood Watch for portions of central Georgia...east \ncentral Georgia...north central Georgia...northeast Georgia... \nnorthwest Georgia and west central Georgia...including the \nfollowing areas...in central Georgia...Baldwin...Butts... \nJasper...Jones...Monroe and Putnam. In east central Georgia... \nGreene...Hancock...Taliaferro...Warren and Wilkes. In north \ncentral Georgia...Barrow...Clayton...Cobb...DeKalb...Douglas...\nFayette...Gwinnett...Henry...Morgan...Newton...North Fulton...\nRockdale...South Fulton and Walton. In northeast Georgia... \nClarke...Jackson...Madison...Oconee and Oglethorpe. In \nnorthwest Georgia...Carroll...Haralson and Paulding. In west \ncentral Georgia...Coweta...Harris...Heard...Lamar... \nMeriwether...Pike...Spalding...Talbot...Troup and Upson. \n\n* Through Wednesday morning\n\n* A weak frontal boundary will remain stationary across west\ncentral Georgia through the Atlanta Metro to near Athens through\ntonight. Heavy rainfall occurred along the Interstate 20 \ncorridor Monday night\/early Tuesday morning with widespread \nvalues between one and three inches, with some spotty 4 to 6 \ninches. An additional one to three inches with locally higher \namounts is possible through the day Tuesday and into the \novernight hours. \n\n* Flooding in low lying and flood prone areas will be possible,\nespecially in urban areas along the Interstate 20 corridor. In \naddition, creeks, streams and rivers may overflow their banks.\n\nPRECAUTIONARY\/PREPAREDNESS ACTIONS...\n\nA Flash Flood Watch means that conditions may develop that lead\nto flash flooding. Flash flooding is a very dangerous situation.\n\nYou should monitor later forecasts and be prepared to take action\nshould Flash Flood Warnings be issued.\n\n&&"
   },
   "timestamps":{
      "issued":1497943140,
      "issuedISO":"2017-06-20T03:19:00-04:00",
      "begins":1497943140,
      "beginsISO":"2017-06-20T03:19:00-04:00",
      "expires":1498046400,
      "expiresISO":"2017-06-21T08:00:00-04:00",
      "added":1497943172,
      "addedISO":"2017-06-20T03:19:32-04:00"
   },
   "poly":"",
   "geoPoly":null,
   "includes":{
      "counties":[
         "GAC009",
         "GAC013",
         "GAC035",
         "GAC045",
         "GAC121",
         "GAC131",
         "GAC293",
         "GAC301",
         "GAC317"
      ],
      "fips":[
         "13009",
         "13013",
         "13035",
         "13285",
         "13293",
         "13297",
         "13301",
         "13317"
      ],
      "wxzones":[
         "GAZ025",
         "GAZ027",
         "GAZ031",
         "GAZ071",
         "GAZ072",
         "GAZ073",
         "GAZ078",
         "GAZ079"
      ],
      "zipcodes":[
         30002,
         30003,
         30004,
         30005,
         30006,
         30007,
         30008,
         31830,
         31831,
         31833,
         31836,
         39901
      ]
   },
   "place":{
      "name":"coweta",
      "state":"ga",
      "country":"us"
   },
   "profile":{
      "tz":"America\/New_York"
   },
   "active":true
}
								

{
   "type":"FeatureCollection",
   "features":[
      {
         "type":"Feature",
         "geometry":{
            "type":"Point",
            "coordinates":[
               -84.76328,
               33.35346
            ]
         },
         "properties":{
            "id":"4f040eedfd58153800598f59c39c44f9",
            "loc":{
               "long":-84.76328,
               "lat":33.35346
            },
            "details":{
               "type":"FF.A",
               "name":"FLASH FLOOD WATCH",
               "loc":"GAZ053",
               "emergency":false,
               "color":"32CD32",
               "body":"...FLASH FLOOD WATCH IN EFFECT THROUGH WEDNESDAY MORNING...\n\nThe National Weather Service in Peachtree City has issued a\n\n* Flash Flood Watch for portions of central Georgia...east \ncentral Georgia...north central Georgia...northeast Georgia... \nnorthwest Georgia and west central Georgia...including the \nfollowing areas...in central Georgia...Baldwin...Butts... \nJasper...Jones...Monroe and Putnam. In east central Georgia... \nGreene...Hancock...Taliaferro...Warren and Wilkes. In north \ncentral Georgia...Barrow...Clayton...Cobb...DeKalb...Douglas...\nFayette...Gwinnett...Henry...Morgan...Newton...North Fulton...\nRockdale...South Fulton and Walton. In northeast Georgia... \nClarke...Jackson...Madison...Oconee and Oglethorpe. In \nnorthwest Georgia...Carroll...Haralson and Paulding. In west \ncentral Georgia...Coweta...Harris...Heard...Lamar... \nMeriwether...Pike...Spalding...Talbot...Troup and Upson. \n\n* Through Wednesday morning\n\n* A weak frontal boundary will remain stationary across west\ncentral Georgia through the Atlanta Metro to near Athens through\ntonight. Heavy rainfall occurred along the Interstate 20 \ncorridor Monday night\/early Tuesday morning with widespread \nvalues between one and three inches, with some spotty 4 to 6 \ninches. An additional one to three inches with locally higher \namounts is possible through the day Tuesday and into the \novernight hours. \n\n* Flooding in low lying and flood prone areas will be possible,\nespecially in urban areas along the Interstate 20 corridor. In \naddition, creeks, streams and rivers may overflow their banks.\n\nA Flash Flood Watch means that conditions may develop that lead\nto flash flooding. Flash flooding is a very dangerous situation.\n\nYou should monitor later forecasts and be prepared to take action\nshould Flash Flood Warnings be issued.",
               "bodyFull":"WGUS62 KFFC 200719\nFFAFFC\n\nURGENT - IMMEDIATE BROADCAST REQUESTED\nFlood Watch\nNational Weather Service Peachtree City GA\n319 AM EDT Tue Jun 20 2017\n\n\n\nGAZ025-027-031>039-041>062-066>073-078-079-201530-\n\/O.NEW.KFFC.FF.A.0006.170620T0719Z-170621T1200Z\/\n\/00000.0.ER.000000T0000Z.000000T0000Z.000000T0000Z.OO\/\nJackson-Madison-Paulding-Cobb-North Fulton-Gwinnett-Barrow-Clarke-\nOconee-Oglethorpe-Wilkes-Haralson-Carroll-Douglas-South Fulton-\nDeKalb-Rockdale-Walton-Newton-Morgan-Greene-Taliaferro-Heard-\nCoweta-Fayette-Clayton-Spalding-Henry-Butts-Jasper-Putnam-Hancock-\nWarren-Troup-Meriwether-Pike-Upson-Lamar-Monroe-Jones-Baldwin-\nHarris-Talbot-\nIncluding the cities of Marietta, Atlanta, Lawrenceville, Athens,\nCarrollton, Douglasville, East Point, Decatur, Conyers, \nCovington, Newnan, Peachtree City, Griffin, and Milledgeville\n319 AM EDT Tue Jun 20 2017\n\n\n\n...FLASH FLOOD WATCH IN EFFECT THROUGH WEDNESDAY MORNING...\n\nThe National Weather Service in Peachtree City has issued a\n\n* Flash Flood Watch for portions of central Georgia...east \ncentral Georgia...north central Georgia...northeast Georgia... \nnorthwest Georgia and west central Georgia...including the \nfollowing areas...in central Georgia...Baldwin...Butts... \nJasper...Jones...Monroe and Putnam. In east central Georgia... \nGreene...Hancock...Taliaferro...Warren and Wilkes. In north \ncentral Georgia...Barrow...Clayton...Cobb...DeKalb...Douglas...\nFayette...Gwinnett...Henry...Morgan...Newton...North Fulton...\nRockdale...South Fulton and Walton. In northeast Georgia... \nClarke...Jackson...Madison...Oconee and Oglethorpe. In \nnorthwest Georgia...Carroll...Haralson and Paulding. In west \ncentral Georgia...Coweta...Harris...Heard...Lamar... \nMeriwether...Pike...Spalding...Talbot...Troup and Upson. \n\n* Through Wednesday morning\n\n* A weak frontal boundary will remain stationary across west\ncentral Georgia through the Atlanta Metro to near Athens through\ntonight. Heavy rainfall occurred along the Interstate 20 \ncorridor Monday night\/early Tuesday morning with widespread \nvalues between one and three inches, with some spotty 4 to 6 \ninches. An additional one to three inches with locally higher \namounts is possible through the day Tuesday and into the \novernight hours. \n\n* Flooding in low lying and flood prone areas will be possible,\nespecially in urban areas along the Interstate 20 corridor. In \naddition, creeks, streams and rivers may overflow their banks.\n\nPRECAUTIONARY\/PREPAREDNESS ACTIONS...\n\nA Flash Flood Watch means that conditions may develop that lead\nto flash flooding. Flash flooding is a very dangerous situation.\n\nYou should monitor later forecasts and be prepared to take action\nshould Flash Flood Warnings be issued.\n\n&&"
            },
            "timestamps":{
               "issued":1497943140,
               "issuedISO":"2017-06-20T03:19:00-04:00",
               "begins":1497943140,
               "beginsISO":"2017-06-20T03:19:00-04:00",
               "expires":1498046400,
               "expiresISO":"2017-06-21T08:00:00-04:00",
               "added":1497943172,
               "addedISO":"2017-06-20T03:19:32-04:00"
            },
            "poly":"",
            "geoPoly":null,
            "includes":{
               "counties":[
                  "GAC009",
                  "GAC013",
                  "GAC035",
                  "GAC045",
                  "GAC121",
                  "GAC131",
                  "GAC293",
                  "GAC301",
                  "GAC317"
               ],
               "fips":[
                  "13009",
                  "13013",
                  "13035",
                  "13285",
                  "13293",
                  "13297",
                  "13301",
                  "13317"
               ],
               "wxzones":[
                  "GAZ025",
                  "GAZ027",
                  "GAZ031",
                  "GAZ071",
                  "GAZ072",
                  "GAZ073",
                  "GAZ078",
                  "GAZ079"
               ],
               "zipcodes":[
                  30002,
                  30003,
                  30004,
                  30005,
                  30006,
                  30007,
                  30008,
                  31830,
                  31831,
                  31833,
                  31836,
                  39901
               ]
            },
            "place":{
               "name":"coweta",
               "state":"ga",
               "country":"us"
            },
            "profile":{
               "tz":"America\/New_York"
            },
            "active":true
         }
      }
   ]
}
								

Response Properties

The following properties will be provided in every response object:

id (string) The ID attribute identifying the alert
loc (object) The object containing the latitude/longitude of the alert centroid
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.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.
details.bodyFull (string) The complete, unmodified version of the alert body text, including headers.
timestamps.issued (number) UNIX timestamp when the alert was issued by the NWS.
timestamps.issuedISO (string) ISO 8601 date of the time when the alert was issued.
timestamps.begins (number) UNIX timestamp when the alert goes into effect.
timestamps.beginsISO (string) ISO 8601 date of the time when the alert goes into effect.
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 alert was stored.
timestamps.addedISO (string) ISO 8601 date of the time when the alert was stored.
poly (string) 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.
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.
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.
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.