# Guide

The Weather Alarms API provides threshold-based weather alerts for a given location over various time intervals.

For full request and response field details, see [Weather Alarms Parameters](/developers/weather-alarms/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 |
|---|---|
| [1 day weather alarms](#1-day-weather-alarms-by-location-key) | Weather alarms for the next day |
| [5 day weather alarms](#5-day-weather-alarms-by-location-key) | Weather alarms for the next 5 days |
| [10 day weather alarms](#10-day-weather-alarms-by-location-key) | Weather alarms for the next 10 days |
| [15 day weather alarms](#15-day-weather-alarms-by-location-key) | Weather alarms for the next 15 days |
| [25 day weather alarms](#25-day-weather-alarms-by-location-key) | Weather alarms for the next 25 days |

## 1 day weather alarms by location key

```
https://{baseUrl}/alarms/{version}/1day/{locationKey}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/alarms/v1/1day/335315?apikey={your key}
```

```json
[
    {
        "Date": "2013-05-11T01:00:00-04:00",
        "EpochDate": 1368234000,
        "Alarms": [
            {
                "AlarmType": "Rain",
                "Value": {
                    "Metric": {
                        "Value": 18.39,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.72,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Day": {
                    "Metric": {
                        "Value": 11.3,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.44,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Night": {
                    "Metric": {
                        "Value": 7.09,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.28,
                        "Unit": "in",
                        "UnitType": 1
                    }
                }
            }
        ],
        "MobileLink": "https://m.accuweather.com/es/us/state-college-pa/16801/daily-weather-forecast/335315?day=1&lang=en-us",
        "Link": "https://www.accuweather.com/es/us/state-college-pa/16801/daily-weather-forecast/335315?day=1&lang=en-us"
    }
]
```

## 5 day weather alarms by location key

```
https://{baseUrl}/alarms/{version}/5day/{locationKey}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/alarms/v1/5day/21-49427_1_al?apikey={your key}
```

```json
[
    {
        "Date": "2018-08-16T01:00:00-02:30",
        "EpochDate": 1534381200,
        "Alarms": [
            {
                "AlarmType": "Rain",
                "Value": {
                    "Metric": {
                        "Value": 16.76,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.66,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Day": {
                    "Metric": {
                        "Value": 11.79,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.46,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Night": {
                    "Metric": {
                        "Value": 4.98,
                        "Unit": "mm",
                        "UnitType": 3
                    },
                    "Imperial": {
                        "Value": 0.2,
                        "Unit": "in",
                        "UnitType": 1
                    }
                }
            }
        ],
        "MobileLink": "https://m.accuweather.com/en/ca/st-johns/a1b/daily-weather-forecast/21-49427_1_al?day=2&lang=en-us",
        "Link": "https://www.accuweather.com/en/ca/st-johns/a1b/daily-weather-forecast/21-49427_1_al?day=2&lang=en-us"
    },
    ...
]
```

## 10 day weather alarms by location key

```
https://{baseUrl}/alarms/{version}/10day/{locationKey}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/alarms/v1/10day/335315?apikey={your key}
```

```json
[
    {
        "Date": "2012-12-21T00:00:00-05:00",
        "EpochDate": 1356048000,
        "Alarms": [
            {
                "AlarmType": "Snow",
                "Value": {
                    "Metric": {
                        "Value": 3.43,
                        "Unit": "cm",
                        "UnitType": 4
                    },
                    "Imperial": {
                        "Value": 1.35,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Day": {
                    "Metric": {
                        "Value": 0.74,
                        "Unit": "cm",
                        "UnitType": 4
                    },
                    "Imperial": {
                        "Value": 0.29,
                        "Unit": "in",
                        "UnitType": 1
                    }
                },
                "Night": {
                    "Metric": {
                        "Value": 2.69,
                        "Unit": "cm",
                        "UnitType": 4
                    },
                    "Imperial": {
                        "Value": 1.06,
                        "Unit": "in",
                        "UnitType": 1
                    }
                }
            }
        ],
        "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/daily-weather-forecast/335315?day=1&lang=en-us",
        "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/daily-weather-forecast/335315?day=1&lang=en-us"
    },
    ...
]
```

## 15 day weather alarms by location key

```
https://{baseUrl}/alarms/{version}/15day/{locationKey}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/alarms/v1/15day/335315?apikey={your key}
```

Response format is the same as the 10 day alarms endpoint.

## 25 day weather alarms by location key

```
https://{baseUrl}/alarms/{version}/25day/{locationKey}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/alarms/v1/25day/335315?apikey={your key}
```

Response format is the same as the 10 day alarms endpoint.