# 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](/developers/languages).            | `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](/developers/locations/general) 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](/developers/languages). | `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](/developers/reference/alerts-action). |
| `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](/developers/reference/alarm-level). 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](/developers/reference/alerts-action).                                                                                                                                                                                                       |
| `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                                                                                                                                                                                                                                                                              |
