# Guide


The Alerts API provides severe weather alerts by location, including both AccuWeather-issued alerts and government-issued warnings.

For full request and response field details, see [Alerts Parameters](/developers/alerts/parameters).

:::note{title="Base URLs"}

- **Production:** api.accuweather.com
- **Development:** apidev.accuweather.com

Examples below use the production host. Swap in apidev.accuweather.com for development.

:::

| Endpoint | Description |
|---|---|
| [Active AccuWeather alerts](#active-accuweather-alerts) | All currently active AccuWeather-issued alerts |
| [Government-issued alerts by location key](#government-issued-alerts-by-location-key) | Government-issued alerts for a specific location |

---

## Active AccuWeather alerts

Retrieve all currently active AccuWeather-issued alerts, optionally filtered by category.

```
https://{baseUrl}/alerts/{version}/accu/active{.format}?apikey={API key}&category={alert category}&language={language code}
```

### Example

```
https://api.accuweather.com/alerts/v1/accu/active.geojson?apikey={API key}&category=non-precipitation&language=en-us
```

```json
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [-114.179229850861, 48.9999170996859],
            [-114.281532753159, 49.0011050469699],
            [-113.692261372458, 48.4162276469935],
            [-113.171215326369, 47.9325358236918],
            [-113.061331363726, 47.1868724521563],
            [-112.482742733366, 47.3222904224389],
            [-112.650591339177, 48.0909905635408],
            [-113.620487424451, 48.9966879208716],
            [-113.895619975974, 48.9966236570762],
            [-114.179229850861, 48.9999170996859]
          ]
        ]
      },
      "properties": {
        "countryCode": "US",
        "dataSourceId": 1,
        "dataSource": "AccuWeather",
        "alertId": 168916,
        "description": {
          "localized": "Dangerous Weather Imminent! High Winds",
          "english": "Dangerous Weather Imminent! High Winds"
        },
        "text": "AccuWeather meteorologists believe strong winds exceeding 65 mph are likely...",
        "category": "NON-PRECIPITATION",
        "priority": 6,
        "colorHex": "#DAA520",
        "startTime": "2026-02-26T11:04:00+00:00",
        "endTime": "2026-02-27T12:00:00+00:00",
        "lastAction": {
          "localized": "New",
          "english": "New"
        }
      }
    }
    // ...additional features omitted
  ]
}
```

---

## Government-issued alerts by location key

Retrieve government-issued severe weather alerts for a specific location.

```
https://{baseUrl}/alerts/{version}/{location key}{.format}?apikey={API key}&language={language code}&details={Boolean}
```

### Examples

**Basic request:**

```
https://api.accuweather.com/alerts/v1/56325.json?apikey={your key}
```

```json
[
  {
    "CountryCode": "CA",
    "AlertID": 255675,
    "Description": {
      "Localized": "Winter Storm Warning",
      "English": "Winter Storm Warning"
    },
    "Category": "WINTER",
    "Priority": 16,
    "Type": "winter storm warning",
    "TypeID": "CA141",
    "Class": null,
    "Level": "Severe",
    "AlarmLevel": "Orange",
    "Source": "Environment Canada",
    "SourceId": 3,
    "Disclaimer": null,
    "Area": [
      {
        "Name": "R.M. of Caledonia including Milestone and Parry",
        "StartTime": "2022-04-22T07:17:00-06:00",
        "EpochStartTime": 1650633420,
        "EndTime": "2022-04-22T23:17:00-06:00",
        "EpochEndTime": 1650691020,
        "LastAction": {
          "Localized": "Continue",
          "English": "Continue"
        },
        "Summary": "Winter Storm Warning in effect until 11:17 PM CST.  Source: Environment Canada"
      }
    ],
    "HaveReadyStatements": true,
    "MobileLink": "https://www.accuweather.com/en/ca/milestone/s0g/weather-warnings/56325?lang=en-us",
    "Link": "https://www.accuweather.com/en/ca/milestone/s0g/weather-warnings/56325?lang=en-us"
  }
]
```

**Request with details:**

```
https://api.accuweather.com/alerts/v1/56325.json?apikey={your key}&details=true
```

```json
[
  {
    "CountryCode": "CA",
    "AlertID": 255675,
    "Description": {
      "Localized": "Winter Storm Warning",
      "English": "Winter Storm Warning"
    },
    "Category": "WINTER",
    "Priority": 16,
    "Type": "winter storm warning",
    "TypeID": "CA141",
    "Class": null,
    "Level": "Severe",
    "AlarmLevel": "Orange",
    "Color": {
      "Name": "MediumBlue",
      "Red": 0,
      "Green": 0,
      "Blue": 205,
      "Hex": "#0000CD"
    },
    "Source": "Environment Canada",
    "SourceId": 3,
    "Disclaimer": null,
    "Area": [
      {
        "Name": "R.M. of Caledonia including Milestone and Parry",
        "StartTime": "2022-04-22T07:17:00-06:00",
        "EpochStartTime": 1650633420,
        "EndTime": "2022-04-22T23:17:00-06:00",
        "EpochEndTime": 1650691020,
        "LastAction": {
          "Localized": "Continue",
          "English": "Continue"
        },
        "Text": "winter storm warning in effect\nA major winter storm is expected.\n\nHeavy snow with total accumulations of 25 to 50 cm to parts of southeastern Saskatchewan on Saturday as a major low moves through.\n\n...",
        "LanguageCode": "en-CA",
        "Summary": "Winter Storm Warning in effect until 11:17 PM CST.  Source: Environment Canada"
      }
    ],
    "HaveReadyStatements": true,
    "MobileLink": "https://www.accuweather.com/en/ca/milestone/s0g/weather-warnings/56325?lang=en-us",
    "Link": "https://www.accuweather.com/en/ca/milestone/s0g/weather-warnings/56325?lang=en-us"
  }
]
```