# Government Push Alerts AccuWeather’s Government Push Alerts data provides users with a consistent format for official weather alerts sourced from meteorological agencies around the world. Instead of polling for updates, alerts are pushed to you. Data is delivered via [Amazon's Simple Notification Service](https://aws.amazon.com/sns/) (SNS) in real time, so you are always up to date with the latest government-issued alerts as they are published. :::info{title="Real-time push delivery"} Government Push Alerts is a **push** product—there is no endpoint to poll. Once your queue is connected, AccuWeather publishes each new or updated government alert to your Amazon SNS topic as it happens. See the [setup guide](/developers/government-push-alerts/setup) to connect your AWS account. ::: ## What you get - **Worldwide coverage:** alerts normalized from many national and regional meteorological agencies into one schema. - **Real-time delivery:** new issuances, updates, extensions, and cancellations arrive as they happen. - **Rich, structured payloads:** severity, urgency, and affected areas in every message. ## Data elements | Field | Type | Description | | ---------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `warningTypeCode` | string | A country-specific alphanumeric code. This value is used in combination with the `countryCode`, `eventLevel`, and `eventClass` to generate the `globalWarningTypeId`. | | `productId` | integer | A unique ID for the bulletin. This value is populated using the same method as `sourceID`, so both values typically match. | | `countryCode` | string | A two-letter code for the country involved in the alert. The code is derived from ISO 3166-1. See api.accuweather.com/alerts/v1/countries/supported? for a full code list. | | `eventId` | integer | An ID number assigned to the event that is unique within a country. This number combines with `dataSourceId` to form a globally unique ID. | | `productDateTime` | string | The date and time of the most recent alert issuance in UTC format (YYYY-MM-DDTHH:MM:SSZ). | | `globalWarningTypeID` | integer | A globally-unique identifier for `warningTypeCode`, `countryCode`, `eventLevel`, and `eventClass`. See api.accuweather.com/alerts/v1/types? for a full alert type list. | | `globalWarningDescription` | string | A short text string that indicates the alert type. | | `eventLevel` | string | An event severity indicator. When presented as a number, higher numbers are more severe. See the [`eventClass`/`eventLevel` table](/developers/reference/event-class-level) for valid value combinations. | | `eventClass` | string | A single-word description of the event type, such as `warning`, `bulletin`, `alert`, and `advisory`. See the [`eventClass`/`eventLevel` table](/developers/reference/event-class-level) for valid value combinations. | | `urgency` | string | A code that indicates a timeline for responsive action. Values are `Immediate`, `Expected`, `Future`, `Past`, and `Unknown`. Can be null. See the ITU CAP recommendation document (ITU-T X.1303) for more information. | | `certaintly` (sic) | string | A code that indicates the event's likelihood. Values are `Observed`, `Likely`, `Possible`, `Unlikely`, and `Unknown`. Can be null. See the ITU CAP recommendation document (ITU-T X.1303) for more information. | | `severity` | string | A code that indicates the event's threat to life or property. Values are `Extreme`, `Severe`, `Moderate`, `Minor`, and `Unknown`. Can be null. See the ITU CAP recommendation document (ITU-T X.1303) for more information. | | `issuingOffice` | string | The name of the agency or authority that issued this alert. | | `headerText` | array | An array that contains message-level text and accompanying metadata. | | `headerText.text` | string | Message-level information in text format. Can be null. | | `headerText.languageCode` | string | A code that denotes the message-level text language. | | `trailerText` | array | An array that contains message-level text and accompanying metadata. | | `trailerText.text` | string | Message-level information in text format. | | `trailerText.languageCode` | string | A code that denotes the message-level text language. | | `textInformation` | array | An array that containes information for all text segments in the bulletin. | | `textInformation.id` | integer | An identification number for a text segment within the bulletin. Numbering begins at 0 for the first segment. | | `textInformation.globalTextId` | integer | A globally-unique identifier for the text segment. Often null or absent. | | `textInformation.headline` | string | The alert message headline. Can be null. | | `textInformation.description` | string | Text that describes the alert message subject event. English only. Can be null. | | `textInformation.instructions` | string | The recommended actions for alert recipients. Can be null. | | `textInformation.text` | string | The full alert text as provided by the issuing office. | | `textInformation.languageCode` | string | A code that denotes the alert language. | | `areas` | array | An array that contains the areas included in the alert. | | `areas.locations` | array | An array that contains location codes for all affected areas. | | `areas.postalCodes` | array | An array that contains postal codes for all affected areas. | | `areas.pointsOfInterest` | array | An array that contains point-of-interest codes for all affected areas. | | `areas.warningAreaCodes` | string | An array that contains country-specific alphanumeric codes that define precise geographic areas within that country. Search local agencies for more information about codes within a specific country. | | `areas.textInformationIds` | integer | An array that lists text segments that are applicable to the current region. The list begins at 0. Can be null. | | `areas.globalWarningAreaIds` | integer | An array that contains unique global area identifiers. The identifiers are a combination of `warningAreaCode`, `countryCode`, `eventLevel`, and `eventClass`. | | `areas.lastAction` | string | A single-word value that describes the alert's most recent update. [See here for possible values.](/developers/reference/alerts-action) | | `areas.startDateTime` | string | The UTC date and time at which the alert takes effect, displayed in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). | | `areas.endDateTime` | string | The UTC date and time at which the alert ends, displayed in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Can be null. | | `areas.expireDateTime` | string | The UTC date and time at which the cache is set to expire, displayed in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). | | `areas.globalTextIds` | array | An array that lists all applicable text segments. Frequently null when not mapped. | | `areas.globalWarningAreas` | array | An array that contains the unique global area identification number(s) and name(s). | | `areas.globalWarningAreas.id` | integer | A unique global area identification number. This identification value is a combination of `areas.warningAreaCodes`, `countryCode`, `eventLevel`, and `eventClass`. | | `areas.globalWarningAreas.name` | string | The location name. | | `features` | object | A GeoJSON object that contains geographical information for the alert. Can be null. | | `features.type` | string | The GeoJSON feature type. | | `features.features` | array | An array that contains feature arrays. | | `features.features.type` | string | The style of geographical feature used to encompass the alert region. | | `features.features.geometry` | object | An object that contains feature coordinates within an object. | | `features.features.geometry.coordinates` | array | An array that contains the alert area coordinates. The coordinates provide outer points of the alert area. Points are provided in the format `[longitude, latitude]`. | | `category` | string | The alert type. Values are fire, flood, hazard, marine, non-precipitation, severe, tropical, wind, and winter. | | `dataSourceId` | integer | A numeric identification of the issuing office. | | `cancelled` | Boolean | A flag that indicates the alert has been cancelled or withdrawn. The flag is triggered (true) when `lastAction` is set to `cancel`. Can be null. | | `sourceId` | integer | The bulletin (product) identification number. This value is populated using the same method as `productID`. Both values typically match. | | `test` | Boolean | A flag that indicates if this is a National Weather Service (NWS) test product. The flag is triggered (true) if it is an NWS test product. | | `priority` | integer | A numerical importance ranking of the given alert within the origin country. Lower numbers are higher priority, with 1 as the highest priority. | | `color` | string | The color associated with the alert type. | | `ingestDateTime` | string | The alert's ingest and processing date and time at AccuWeather in UTC format (YYYY-MM-DDTHH:MM:SSZ). | | `processingTimeStamps` | array | An array that contains processing information for analysis purposes. | | `processingTimeStamps.serviceName` | string | The name of the specific processing service for which the time stamps are recorded. | | `processingTimeStamps.serviceType` | string | The processing action for which the time stamps are recorded. | | `processingTimeStamps.receivedDateTime` | string | The date and time the alert was received in UTC format (YYYY-MM-DDTHH:MM:SSZ). | | `processingTimeStamps.processedDateTime` | string | The date and time the alert was delivered in UTC format (YYYY-MM-DDTHH:MM:SSZ). | ## Example payload A single push carries one alert as a JSON object. The example below shows the overall shape and how the nested sections fit together.
Show example alert payload ```json { "warningTypeCode": "FLW", "productId": 123456789, "countryCode": "US", "eventId": 987654, "productDateTime": "2026-07-20T14:30:00Z", "globalWarningTypeID": 42, "globalWarningDescription": "Flood Warning", "eventLevel": "Moderate", "eventClass": "Warning", "urgency": "Expected", "certaintly": "Likely", "severity": "Moderate", "issuingOffice": "NWS Philadelphia/Mount Holly", "headerText": [ { "text": "Flood Warning issued for the following areas", "languageCode": "en-US" } ], "trailerText": [ { "text": "Turn around, don't drown when encountering flooded roads.", "languageCode": "en-US" } ], "textInformation": [ { "id": 0, "globalTextId": null, "headline": "Flood Warning in effect until 8:00 PM EDT", "description": "Heavy rainfall will cause flooding of rivers, creeks, and low-lying areas.", "instructions": "Move to higher ground. Do not drive through flooded roadways.", "text": "The National Weather Service in Mount Holly has issued a Flood Warning...", "languageCode": "en-US" } ], "areas": [ { "locations": ["349727"], "postalCodes": ["08060"], "pointsOfInterest": [], "warningAreaCodes": ["NJC005"], "textInformationIds": [0], "globalWarningAreaIds": [5551234], "lastAction": "New", "startDateTime": "2026-07-20T14:30:00Z", "endDateTime": "2026-07-21T00:00:00Z", "expireDateTime": "2026-07-21T02:00:00Z", "globalTextIds": null, "globalWarningAreas": [{ "id": 5551234, "name": "Burlington County" }] } ], "features": { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [-74.85, 39.95], [-74.65, 39.95], [-74.65, 40.1], [-74.85, 40.1], [-74.85, 39.95] ] ] } } ] }, "category": "flood", "dataSourceId": 7, "cancelled": false, "sourceId": 123456789, "test": false, "priority": 2, "color": "#00FF00", "ingestDateTime": "2026-07-20T14:30:05Z", "processingTimeStamps": [ { "serviceName": "alert-ingest", "serviceType": "ingest", "receivedDateTime": "2026-07-20T14:30:03Z", "processedDateTime": "2026-07-20T14:30:05Z" } ] } ```
## What next? - [Government Push Alerts setup](/developers/government-push-alerts/setup) — connect your AWS account to start receiving pushes. - [Event level and class](/developers/government-push-alerts/event-class-level) — valid `eventLevel`/`eventClass` combinations. - [Alerts action types](/developers/reference/alerts-action) — possible `lastAction` values.