Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-1461669.5 KB

Alerts

Returns a list of weather alerts for the given location, or all weather alerts if no location given.

If you supply either warn_cell_id or both lat and lon, Bright Sky will return additional information on that cell in the location field. Warn cell IDs are municipality (Gemeinde) cell IDs.

Notes

  • The DWD divides Germany's area into roughly 11,000 "cells" based on municipalities (Gemeinden), and issues warnings for each of these cells. Most warnings apply to many cells.
  • Bright Sky will supply information on the cell that a given lat/lon belongs to in the location field.
  • There is also a set of roughly 400 cells based on districts (Landkreise) that is not supported by Bright Sky.
  • The complete list of cells can be found on the DWD GeoServer (see below).

Additional resources

get/alerts

Query parameters

latnumber

Latitude in decimal degrees.

Example:52.52

Latitude in decimal degrees.

lonnumber

Longitude in decimal degrees.

Example:13.4

Longitude in decimal degrees.

warn_cell_idinteger

Municipality warn cell ID.

Example:803159016

Municipality warn cell ID.

tzstring

Timezone in which record timestamps will be presented, as <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">tz database name</a>. Will also be used as timezone when parsing date and last_date, unless these have explicit UTC offsets. If omitted but date has an explicit UTC offset, that offset will be used as timezone. Otherwise will default to UTC.

Example:Europe/Berlin

Timezone in which record timestamps will be presented, as <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">tz database name</a>. Will also be used as timezone when parsing date and last_date, unless these have explicit UTC offsets. If omitted but date has an explicit UTC offset, that offset will be used as timezone. Otherwise will default to UTC.

Response

Successful Response

Example response

{
  "alerts": [
    {
      "id": 279977,
      "alert_id": "2.49.0.0.276.0.DWD.PVW.1691344680000.2cf9fad6-dc83-44ba-9e88-f2827439da59",
      "effective": "2023-08-06T17:58:00+00:00",
      "onset": "2023-08-07T08:00:00+00:00",
      "expires": "2023-08-07T19:00:00+00:00",
      "event_code": 51,
      "event_en": "wind gusts",
      "event_de": "WINDBÖEN",
      "headline_en": "Official WARNING of WIND GUSTS",
      "headline_de": "Amtliche WARNUNG vor WINDBÖEN",
      "description_en": "There is a risk of wind gusts (level 1 of 4).\nMax. gusts: 50-60 km/h; Wind direction: west; Increased gusts: near showers and in exposed locations < 70 km/h",
      "description_de": "Es treten Windböen mit Geschwindigkeiten zwischen 50 km/h (14 m/s, 28 kn, Bft 7) und 60 km/h (17 m/s, 33 kn, Bft 7) aus westlicher Richtung auf. In Schauernähe sowie in exponierten Lagen muss mit Sturmböen bis 70 km/h (20 m/s, 38 kn, Bft 8) gerechnet werden.",
      "instruction_en": "NOTE: Be aware of the following possible dangers: The downpours can cause temporary traffic disruption.",
      "instruction_de": "ACHTUNG! Hinweis auf mögliche Gefahren: Während des Platzregens sind kurzzeitig Verkehrsbehinderungen möglich."
    }
  ],
  "location": {
    "warn_cell_id": 803159016,
    "name": "Stadt Göttingen",
    "name_short": "Göttingen",
    "district": "Göttingen",
    "state": "Niedersachsen",
    "state_short": "NI"
  }
}