Alerts
Parameters
Active AccuWeather alerts — request parameters
| Parameter | Description | Default | Required |
|---|---|---|---|
apikey | Your API key | — | Yes |
version | API version (currently v1) | v1 | Yes |
format | Response format. Only GeoJSON is available for this endpoint. | geojson | Yes |
category | Filter by alert type: flood, non-precipitation, severe, tropical, winter. All categories returned by default. | All | No |
language | Language code for localized content (e.g., en-us, fr-FR). See Language Support. | en-us | No |
Government-issued alerts by location key — request parameters
| Parameter | Description | Default | Required |
|---|---|---|---|
apikey | Your API key | — | Yes |
version | API version (currently v1) | v1 | Yes |
locationkey | Unique location ID. Use the Locations API to find the appropriate key. | — | Yes |
format | Response format. Only JSON is available for this endpoint. | json | Yes |
language | Language code for localized content (e.g., en-us, fr-FR). See Language Support. | en-us | No |
details | Include full alert text, color information, and language code in the response. | false | No |
Active AccuWeather alerts response
| Field | Type | Description |
|---|---|---|
type | string | GeoJSON collection type (FeatureCollection) |
features[] | array | Array of alert features |
features[].type | string | GeoJSON feature type (Feature) |
features[].geometry.type | string | Geometric shape of the alert area (e.g., Polygon) |
features[].geometry.coordinates | array | Geographic coordinates outlining the alert area |
features[].properties.countryCode | string | Two-character country code |
features[].properties.dataSourceId | integer | ID of the alert data provider |
features[].properties.dataSource | string | Name of the alert data provider |
features[].properties.alertId | integer | Unique alert ID |
features[].properties.description.localized | string | Alert summary in the requested language |
features[].properties.description.english | string | Alert summary in US English |
features[].properties.text | string | Full alert description with danger details and safety actions |
features[].properties.category | string | Alert category: FLOOD, NON-PRECIPITATION, SEVERE, TROPICAL, or WINTER |
features[].properties.priority | integer | Urgency ranking (1 = most urgent) |
features[].properties.colorHex | string | Hex color code for the alert type indicator |
features[].properties.startTime | string | Alert start time in ISO 8601 format |
features[].properties.endTime | string | Alert end time in ISO 8601 format |
features[].properties.lastAction.localized | string | Alert status in the requested language. See Alerts Action Reference. |
features[].properties.lastAction.english | string | Alert status in US English |
Government-issued alerts by location key response
| Field | Type | Description |
|---|---|---|
CountryCode | string | Two-character country code |
AlertID | integer | Unique alert ID |
Description.Localized | string | Alert summary in the requested language |
Description.English | string | Alert summary in US English |
Category | string | Alert type classification (FIRE, FLOOD, HAZARD, MARINE, NON-PRECIPITATION, SEVERE, TROPICAL, WIND, WINTER) |
Priority | integer | Urgency ranking based on alert type (1 = highest priority) |
Type | string | Abbreviated alert description |
TypeID | string | Alphanumeric ID for the alert type |
Class | string | Alert classification. Not available for all countries. Can be null. |
Level | string | Alert severity level. Not available for all countries. Can be null. |
AlarmLevel | string | Color-based alert severity. See Alarm Level Reference. Possible values: Red (critical — immediately notify user), Orange (medium — notify user upon any interaction), Yellow (normal — notify user on a schedule or when asked), null (default — no alert severity). |
Color | object | Color information associated with the alert. |
Color.Name | string | Named color (e.g., MediumBlue, Maroon). |
Color.Red | integer | Red component of the alert color (0–255). |
Color.Green | integer | Green component of the alert color (0–255). |
Color.Blue | integer | Blue component of the alert color (0–255). |
Color.Hex | string | Hex code for the alert color (e.g., #0000CD). |
Source | string | Alert data provider |
SourceId | integer | ID of the alert data provider |
Disclaimer | string | Required disclaimer text to display with the alert data. Can be null. |
Area[] | array | Array of affected areas, timing, and alert text |
Area[].Name | string | Name of the area under the alert |
Area[].StartTime | string | Alert start time in ISO 8601 format |
Area[].EpochStartTime | integer | Alert start time as epoch seconds |
Area[].EndTime | string | Alert end time in ISO 8601 format |
Area[].EpochEndTime | integer | Alert end time as epoch seconds |
Area[].LastAction.Localized | string | Alert status in the requested language. See Alerts Action Reference. |
Area[].LastAction.English | string | Alert status in US English |
Area[].Text | string | Full alert description. Returned when details=true. |
Area[].LanguageCode | string | Language code of the alert text (e.g., en). Returned when details=true. |
Area[].Summary | string | Brief alert summary |
HaveReadyStatements | boolean | Whether ready statements are available for this alert |
MobileLink | string | Link to alert on AccuWeather mobile site |
Link | string | Link to alert on AccuWeather website |
Last modified on