---
title: "Use to get information about severe weather conditions such as hurricanes,
thunderstorms, flooding, lightning, heat waves or forest fires for a given
location."
method: GET
path: "/weather/severe/alerts/{format}"
---

# Use to get information about severe weather conditions such as hurricanes,
thunderstorms, flooding, lightning, heat waves or forest fires for a given
location.

`GET /weather/severe/alerts/{format}`

Severe weather phenomenon can significantly impact our everyday life and
business operations. For example, severe weather conditions such as tropical
storms, high winds or flooding can close roads and force logistics companies to
reroute their fleet causing delays in reaching destinations and breaking the
cold chain of refrigerated food products.

The `Get Severe Weather Alerts` API is an HTTP `GET` request that returns the
severe weather alerts that are available worldwide from both official
Government Meteorological Agencies and leading global to regional weather alert
providers. The service can return details such as alert type, category, level
and detailed description about the active severe alerts for the requested
location, like hurricanes, thunderstorms, lightning, heat waves or forest
fires. For more information, see [Request severe weather
alerts](/azure/azure-maps/how-to-request-weather-data#request-severe-weather-alerts)

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `query` number[], required
- `language` string
- `details` string

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- SevereWeatherAlertsResult — This object is returned from a successful Get Severe Weather Alerts call.
  - `results` SevereWeatherAlert[] — A list of all severe weather alerts for the queried location.
    - `countryCode` string — 2-character ISO 3166-1 Alpha-2 country code, for example, "US".
    - `alertId` integer — A unique numerical identifier for a weather alert.
    - `description` SevereWeatherAlertDescription — Description of a severe weather alert.
      - `localized` string — Description of the alert in the specified language. By default English (en-US) is returned if the language parameter is not specified in the request.
      - `english` string — Description of the alert in English (en-US).
    - `category` string — Category of the alert.
    - `priority` integer — Number signifying the importance or ranking order of the given alert within the country/region it has originated. A lower number signifies a higher priority. For example, 1 is the highest priority. The number varies by country/region and can change over time as each country/region evolves their alert systems.
    - `class` string — Classification of the alert. This field is not available for all countries and therefore not always returned.
    - `level` string — Severity level of the alert. This field is not available for all countries and therefore not always returned.
    - `source` string — The provider of the alert information. By default the source is returned in English (en-US). The alerts are from official Government Meteorological Agencies and leading global weather alert providers.
    - `sourceId` integer — A numerical identifier associated with the source provider name of the alert data.
    - `disclaimer` string — A disclaimer regarding the source of the alert information. This field is not always available. For example, disclaimer may include details about the delays or potential issues related to the alarm.
    - `alertAreas` AlertArea[] — Information about the alert specific to the affected area(s).
      - `name` string — The name of an area which is affected by the alert. The location that was requested falls under the alert area.
      - `summary` string — Text summarizing the alert in the returned area.
      - `startTime` string, date-time — The start date and time of the alert in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00. If the alert crosses multiple time zones the returned time in the response is the local time to the requested coordinate location.
      - `endTime` string, date-time — The date and time at which the alert ended or will end in [ISO 8601](https://en.wikipedia.org/wiki/ISO_format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*. If the alert spans multiple time zones, the response will provide the local time corresponding to the requested coordinates.
      - `latestStatus` LatestStatus — The latest status on the alert in the current area.
        - `localized` string — The latest status keyword for the alert, in the specified language. By default, returned in English (en-US).
        - `english` 'Cancel' | 'Continue' | 'Correct' | 'Expire' | 'Extend' | 'New' | 'Update' | 'Upgrade' — A predefined list of eight keywords used to describe the current status of a severe weather alert.
      - `alertDetails` string — Full details associated with the alert. Returned if `details=True`. This field is always returned in the language(s) of choice by the issuing provider and Azure Maps only returns what is created by the provider. Please note, some countries/regions may offer their native language and English. Language parameter won't apply to this field.
      - `alertDetailsLanguageCode` string — Language of the `alertDetails`. This field helps to point out that the language of the `alertDetails` may differ from the requested language parameter. Returned if `details=True`. Language code has been derived from the ISO 639-1 Alpha-2 codes.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/revisions/3c076fdd2918/schema)
