# NINA

> Get Germany's official public warnings from NINA, the warning app of the Federal Office of Civil Protection (BBK): civil protection (MoWaS), KATWARN, BIWAPP, weather (DWD), flood and police warnings. Get the warnings for a district or list them for all of Germany, read a warning's full text and advice in one of nine languages, check whether a place lies inside its area, follow a warning's updates and all-clear, and start a workflow when a new warning is issued for a district. Districts are picked by name. No account or API key required.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/nina

## Actions

### Find a district

Look up the district a town or city is in, by name or regional key, from the official German lists, with the key the other steps take. Use it when the place comes from a form or a spreadsheet rather than the district list.

**Inputs**

- Place (`search`, text, required): A town, city or district name, or a regional key (ARS) or municipality key (AGS).
- How many to return (`limit`, number): The most matches to return, best first. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many came back
- `matched_count` (number): How many matched before the limit trimmed the list
- `regions` (list): The districts and municipalities that matched, best first
- `search` (text): What was searched for

**Example output**

```json
{
  "count": 2,
  "matched_count": 3,
  "regions": [
    {
      "district_name": "G\u00f6ttingen",
      "kind": "district",
      "municipality_key": "",
      "name": "G\u00f6ttingen",
      "region_key": "031590000000",
      "state": "Niedersachsen"
    },
    {
      "district_name": "G\u00f6ttingen",
      "kind": "municipality",
      "municipality_key": "031590016016",
      "name": "G\u00f6ttingen, Stadt",
      "region_key": "031590000000",
      "state": "Niedersachsen"
    }
  ],
  "search": "G\u00f6ttingen"
}
```

### Get a warning

Get the full text of one warning: what is happening, what to do, who issued it, the areas it covers and when it starts and ends, as plain text in the language you choose. Ended civil protection warnings come from NINA's archive.

**Inputs**

- Warning (`warning_id`, text, required): The warning's id, which every list of warnings and the New warning trigger return.
- Language (`language`, text): The language of the text. Where the warning has no translation, it comes back in German; civil protection warnings often translate only the headline and the advice. One of: `en` (English), `de` (German), `de-LS` (Easy German (Leichte Sprache)), `fr` (French), `es` (Spanish), `pl` (Polish), `ru` (Russian), `tr` (Turkish), `ar` (Arabic). Default: `en`.

**Outputs**

- `areas` (list): The areas it covers, as the authority names them
- `category` (text): What kind of danger, such as Met, Safety, Health or Fire
- `certainty` (text): observed, likely or possible
- `contact` (text): Who to contact, where there is someone
- `description` (text): What is happening, as plain text; civil protection warnings are often in German only
- `effective` (text): When the warning takes effect; often empty
- `event` (text): The event, such as STURMBÖEN or Gefahreninformation
- `event_code` (text): The BBK event code, such as BBK-EVC-079 for an unexploded bomb; empty for weather warnings
- `expires` (text): When it ends; empty when it holds until further notice
- `headline` (text): The headline in that language
- `id` (text): NINA's id for the warning, which 'Get a warning' takes
- `instruction` (text): What to do, as plain text
- `is_all_clear` (true/false): True when this message lifts the warning (an all-clear)
- `is_archived` (true/false): True when the warning has ended and is served from NINA's archive
- `language` (text): The language of the text that came back: the one asked for, or German
- `languages` (list): Every language the warning comes in; de-LS is Leichte Sprache (easy German)
- `msg_type` (text): Alert for a new warning, Update for a change, Cancel for an all-clear
- `onset` (text): When the danger starts; often empty
- `references` (list): The ids of the earlier messages this one updates or lifts
- `response_type` (text): What people should do, where the source says, such as Prepare
- `sender` (text): The sending authority's id
- `sender_name` (text): Who issued it, such as Deutscher Wetterdienst or a district's control centre
- `sent` (text): When the warning was sent
- `severity` (text): minor, moderate, severe or extreme
- `source` (text): mowas, katwarn, biwapp, dwd, lhp or police
- `source_name` (text): The source as a person knows it, such as Weather (DWD)
- `status` (text): Actual, or Exercise or Test
- `urgency` (text): immediate, expected or future
- `web` (text): A web page with more, where there is one

**Example output**

```json
{
  "areas": [
    "G\u00f6ttingen"
  ],
  "category": "Safety",
  "certainty": "observed",
  "contact": "",
  "description": "Am Donnerstag, 22. Oktober 2026, werden mehrere Kampfmittel aus dem Zweiten Weltkrieg unterhalb der B27 an der Gronebr\u00fccke kontrolliert gesprengt. Zur Sicherheit der Bev\u00f6lkerung werden am Donnerstag, 22. Oktober 2026, ab 11.00 Uhr alle Personen im Radius von 300 Metern um die Fundstelle herum evakuiert.",
  "effective": "",
  "event": "Gefahreninformation",
  "event_code": "BBK-EVC-079",
  "expires": "",
  "headline": "Second World War bomb",
  "id": "mow.DE-NI-GOE-W264-20261021-000",
  "instruction": "Avoid the affected area.\nFind out more, for example, on local radio.\nPay attention to announcements made by the police and fire brigade.",
  "is_all_clear": false,
  "is_archived": false,
  "language": "en",
  "languages": [
    "de",
    "de-LS",
    "en",
    "ar",
    "es",
    "fr",
    "pl",
    "ru",
    "tr"
  ],
  "msg_type": "Alert",
  "onset": "",
  "references": [],
  "response_type": "",
  "sender": "DE-NI-GOE-W264",
  "sender_name": "Kommunale Regionalleitstelle G\u00f6ttingen",
  "sent": "2026-10-21T14:45:32+02:00",
  "severity": "minor",
  "source": "mowas",
  "source_name": "Civil protection (MoWaS)",
  "status": "Actual",
  "urgency": "immediate",
  "web": ""
}
```

### Get a warning's area

Get the area a warning covers, as a box, a centre point and the GeoJSON shape for a map, and check whether a place lies inside it. Use it to tell the people at one address whether an evacuation or a bomb disposal zone includes them.

**Inputs**

- Warning (`warning_id`, text, required): The warning's id, which every list of warnings and the New warning trigger return.
- Latitude (`latitude`, number): To check a place, its latitude in decimal degrees, such as 51.5413. Leave it and the longitude empty to read the area alone.
- Longitude (`longitude`, number): The place's longitude in decimal degrees, such as 9.9158.

**Outputs**

- `bounding_box` (object): The smallest box around every area, in degrees
- `centre` (object): The middle of that box
- `colour` (text): The colour NINA's map draws the area in, such as #FB8C00
- `contains_place` (true/false): Whether the place asked about lies inside the area; null when no place was given
- `geojson` (object): The area itself, as a GeoJSON FeatureCollection for a map
- `id` (text): NINA's id for the warning, which 'Get a warning' takes
- `latitude` (number): The latitude asked about, null when none was given
- `longitude` (number): The longitude asked about, null when none was given
- `polygon_count` (number): How many separate areas the warning covers

**Example output**

```json
{
  "bounding_box": {
    "east": 9.9174,
    "north": 51.561,
    "south": 51.5543,
    "west": 9.9083
  },
  "centre": {
    "latitude": 51.55765,
    "longitude": 9.91285
  },
  "colour": "#FB8C00",
  "contains_place": true,
  "geojson": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            [
              [
                9.9083,
                51.5595
              ],
              [
                9.9117,
                51.561
              ],
              [
                9.9168,
                51.5596
              ],
              [
                9.9174,
                51.5575
              ],
              [
                9.9122,
                51.5543
              ],
              [
                9.9084,
                51.5589
              ],
              [
                9.9083,
                51.5595
              ]
            ]
          ],
          "type": "Polygon"
        },
        "properties": {
          "fillColor": "#FB8C00",
          "warnId": "mow.DE-NI-GOE-W264-20261021-000"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "id": "mow.DE-NI-GOE-W264-20261021-000",
  "latitude": 51.5576,
  "longitude": 9.9128,
  "polygon_count": 1
}
```

### Get a warning's history

Get every version of a civil protection (MoWaS) warning: the first alert, each update and the all-clear, oldest first. Use it to see whether a warning has been lifted, or to report how an incident developed.

**Inputs**

- Warning (`warning_id`, text, required): The warning's id, which every list of warnings and the New warning trigger return.

**Outputs**

- `count` (number): How many versions there are
- `found` (true/false): False when NINA's archive has no history for the warning
- `id` (text): NINA's id for the warning, which 'Get a warning' takes
- `is_all_clear` (true/false): True when the newest version lifted the warning
- `latest_msg_type` (text): What the newest version is: Alert, Update or Cancel
- `versions` (list): Every version, oldest first

**Example output**

```json
{
  "count": 2,
  "found": true,
  "id": "mow.DE-SL-SLS-W038-20260904-000",
  "is_all_clear": false,
  "latest_msg_type": "Update",
  "versions": [
    {
      "headline": "Bakteriologische Beeintr\u00e4chtigung des Trinkwassers - Chlorungsma\u00dfnahmen - Biringen, F\u00fcrweiler, Gerlfangen, Oberesch und Hemmersdorf - Gde. ReSi",
      "msg_type": "Alert",
      "sent": "2026-09-01T16:57:24+02:00",
      "version_id": "mow.DE-SL-SLS-W038-20260901-000_20260901165724"
    },
    {
      "headline": "1. AKTUALISIERUNG: Bakteriologische Beeintr\u00e4chtigung des Trinkwassers - Chlorung - Biringen, F\u00fcrweiler, Gerlfangen und Oberesch - Gde. ReSi",
      "msg_type": "Update",
      "sent": "2026-09-04T13:05:28+02:00",
      "version_id": "mow.DE-SL-SLS-W038-20260904-000_20260904130528"
    }
  ]
}
```

### Get an earlier version of a warning

Get one version of a civil protection (MoWaS) warning exactly as it was sent, from NINA's archive: the full text, advice and areas at that point. The version comes from 'Get a warning's history'.

**Inputs**

- Version (`version_id`, text, required): The version's id, which 'Get a warning's history' returns: the warning id followed by when it was sent.
- Language (`language`, text): The language of the text. Where the warning has no translation, it comes back in German; civil protection warnings often translate only the headline and the advice. One of: `en` (English), `de` (German), `de-LS` (Easy German (Leichte Sprache)), `fr` (French), `es` (Spanish), `pl` (Polish), `ru` (Russian), `tr` (Turkish), `ar` (Arabic). Default: `en`.

**Outputs**

- `areas` (list): The areas it covers, as the authority names them
- `category` (text): What kind of danger, such as Met, Safety, Health or Fire
- `certainty` (text): observed, likely or possible
- `contact` (text): Who to contact, where there is someone
- `description` (text): What is happening, as plain text; civil protection warnings are often in German only
- `effective` (text): When the warning takes effect; often empty
- `event` (text): The event, such as STURMBÖEN or Gefahreninformation
- `event_code` (text): The BBK event code, such as BBK-EVC-079 for an unexploded bomb; empty for weather warnings
- `expires` (text): When it ends; empty when it holds until further notice
- `headline` (text): The headline in that language
- `id` (text): NINA's id for the warning, which 'Get a warning' takes
- `instruction` (text): What to do, as plain text
- `is_all_clear` (true/false): True when this message lifts the warning (an all-clear)
- `is_archived` (true/false): True when the warning has ended and is served from NINA's archive
- `language` (text): The language of the text that came back: the one asked for, or German
- `languages` (list): Every language the warning comes in; de-LS is Leichte Sprache (easy German)
- `msg_type` (text): Alert for a new warning, Update for a change, Cancel for an all-clear
- `onset` (text): When the danger starts; often empty
- `references` (list): The ids of the earlier messages this one updates or lifts
- `response_type` (text): What people should do, where the source says, such as Prepare
- `sender` (text): The sending authority's id
- `sender_name` (text): Who issued it, such as Deutscher Wetterdienst or a district's control centre
- `sent` (text): When the warning was sent
- `severity` (text): minor, moderate, severe or extreme
- `source` (text): mowas, katwarn, biwapp, dwd, lhp or police
- `source_name` (text): The source as a person knows it, such as Weather (DWD)
- `status` (text): Actual, or Exercise or Test
- `urgency` (text): immediate, expected or future
- `version_id` (text): The version that was read
- `web` (text): A web page with more, where there is one

**Example output**

```json
{
  "areas": [
    "Biringen, F\u00fcrweiler, Gerlfangen, Oberesch und Hemmersdorf - Gde. ReSi"
  ],
  "category": "Health",
  "certainty": "observed",
  "contact": "TWRS Technische Werke der Gemeinde Rehlingen-Siersburg GmbH\n06835 501933",
  "description": "Im Bereich der Gemeinde Rehlingen-Siersburg \u2013 in den Ortsteilen Biringen, F\u00fcrweiler, Gerlfangen,\nHemmersdorf und Oberesch \u2013 wurde im Rahmen von Routinekontrollen des Trinkwassers eine\nmikrobiologische Verunreinigung festgestellt.\n\nEs sind nur die genannten Ortsteile betroffen!",
  "effective": "",
  "event": "Gefahreninformation",
  "event_code": "BBK-EVC-069",
  "expires": "",
  "headline": "Trinkwasserverschmutzung",
  "id": "mow.DE-SL-SLS-W038-20260901-000",
  "instruction": "Informieren Sie sich, zum Beispiel im Radio.",
  "is_all_clear": false,
  "is_archived": false,
  "language": "de-LS",
  "languages": [
    "de",
    "de-LS",
    "en",
    "ar",
    "es",
    "fr",
    "pl",
    "ru",
    "tr"
  ],
  "msg_type": "Alert",
  "onset": "",
  "references": [],
  "response_type": "",
  "sender": "DE-SL-SLS-W038",
  "sender_name": "Katastrophenschutzbeh\u00f6rde LK Saarlouis",
  "sent": "2026-09-01T16:57:24+02:00",
  "severity": "minor",
  "source": "mowas",
  "source_name": "Civil protection (MoWaS)",
  "status": "Actual",
  "urgency": "immediate",
  "version_id": "mow.DE-SL-SLS-W038-20260901-000_20260901165724",
  "web": "https://twrs-gmbh.de/"
}
```

### Get emergency tips

Get the BBK's advice on preparing for and getting through an emergency, in German: stocking food and water, cooking without power, a grab bag, finding shelter and more. Use it for a preparedness tip of the week.

**Inputs**

- Topic (`topic`, text): Only this tip. Pick it from the list or type a word from its title; leave it empty for every tip.

**Outputs**

- `count` (number): How many tips came back
- `language` (text): Always de: NINA's tips are in German
- `tips` (list): The tips, in NINA's order
- `topic` (text): The topic asked for, empty for all
- `total_count` (number): How many tips NINA has

**Example output**

```json
{
  "count": 1,
  "language": "de",
  "tips": [
    {
      "category": "Vorsorgen f\u00fcr Krisen und Katastrophen",
      "image_url": "https://warnung.bund.de/api31/appdata/gsb/notfalltipps/DE/images/0_10_0_src.jpg",
      "text": "Bei einem Stromausfall funktioniert Ihr Elektroherd nicht mehr. Haben Sie einen Gasherd, k\u00f6nnen Sie diesen oft weiterhin nutzen. Es gibt auch noch weitere Alternativen:\nDamit k\u00f6nnen Sie in R\u00e4umen kochen:\n- ein St\u00f6vchen mit Teelicht kann Essen aufw\u00e4rmen (zum Beispiel Fertigsuppe)",
      "title": "Ohne Strom kochen"
    }
  ],
  "topic": "Ohne Strom kochen",
  "total_count": 18
}
```

### Get warnings for a district

Get every warning NINA has in force for one district: civil protection, KATWARN, BIWAPP, weather, flood and police warnings, most severe first, each with its level, when it was sent and its title in the language you choose. Use it to check a site's district before work starts, or to post the day's warnings.

**Inputs**

- District (`region`, text, required): The district (Landkreis or city) to read. Pick it from the list, or type its name; a regional key from an earlier step works too, even a town's, and is read as the district the town is in.
- Sources (`sources`, list): Only warnings from these sources: civil protection (MoWaS), KATWARN, BIWAPP, the weather service (DWD), the flood portal (LHP) or the police. Leave it empty for all of them.
- Minimum level (`minimum_severity`, text): Only warnings at this level or higher: minor, moderate, severe or extreme. Leave it empty for every warning.
- Language (`language`, text): The language of each warning's title. The German headline comes back too, since civil protection titles in other languages only name the kind of danger. One of: `en` (English), `de` (German), `fr` (French), `es` (Spanish), `pl` (Polish), `ru` (Russian), `tr` (Turkish), `ar` (Arabic). Default: `en`.

**Outputs**

- `count` (number): How many warnings came back
- `highest_severity` (text): The highest level among them, empty when there are none
- `language` (text): The language asked for
- `minimum_severity` (text): The lowest level asked for, empty for every level
- `region_key` (text): The district's 12-digit regional key (ARS)
- `region_name` (text): The district's name
- `sources` (list): The sources asked for, empty for all of them
- `state` (text): Its federal state
- `total_count` (number): How many are in force before the source and level filters
- `warnings` (list): The warnings in force for the district, most severe first

**Example output**

```json
{
  "count": 1,
  "highest_severity": "moderate",
  "language": "en",
  "minimum_severity": "",
  "region_key": "150850000000",
  "region_name": "Harz",
  "sources": [],
  "state": "Sachsen-Anhalt",
  "total_count": 1,
  "warnings": [
    {
      "event_code": "",
      "expires": "2026-10-23T00:00:00+02:00",
      "headline": "Amtliche WARNUNG vor STURMB\u00d6EN",
      "id": "dwd.2.49.0.0.276.0.DWD.PVW.1792572900000.9acb938b-86ed-4536-bd85-db746f6ac686.MUL",
      "is_all_clear": false,
      "msg_type": "Alert",
      "onset": "2026-10-22T00:00:00+02:00",
      "sent": "2026-10-21T10:54:12+02:00",
      "severity": "moderate",
      "source": "dwd",
      "source_name": "Weather (DWD)",
      "title": "Official WARNING of GALE-FORCE GUSTS",
      "urgency": "immediate",
      "version": 21
    }
  ]
}
```

### List warnings in Germany

List every warning in force anywhere in Germany from the sources you choose, most severe first, with how many each source has. Use it for a nationwide round-up, or to catch the severe and extreme ones wherever they are.

**Inputs**

- Sources (`sources`, list): Only warnings from these sources: civil protection (MoWaS), KATWARN, BIWAPP, the weather service (DWD), the flood portal (LHP) or the police. Leave it empty for all of them.
- Minimum level (`minimum_severity`, text): Only warnings at this level or higher: minor, moderate, severe or extreme. Leave it empty for every warning.
- Language (`language`, text): The language of each warning's title. The German headline comes back too, since civil protection titles in other languages only name the kind of danger. One of: `en` (English), `de` (German), `fr` (French), `es` (Spanish), `pl` (Polish), `ru` (Russian), `tr` (Turkish), `ar` (Arabic). Default: `en`.
- How many to return (`limit`, number): The most warnings to return, most severe first. Defaults to 100; the result says how many matched. From 1 to 500. Default: `100`.

**Outputs**

- `count` (number): How many warnings came back
- `counts_by_source` (object): How many each source has in force
- `highest_severity` (text): The highest level among those that matched, empty when none did
- `language` (text): The language asked for
- `matched_count` (number): How many matched before the limit trimmed the list
- `minimum_severity` (text): The lowest level asked for, empty for every level
- `sources` (list): The sources that were read
- `total_count` (number): How many the chosen sources have in force
- `warnings` (list): The warnings that matched, most severe first, then newest

**Example output**

```json
{
  "count": 2,
  "counts_by_source": {
    "biwapp": 0,
    "dwd": 4,
    "katwarn": 0,
    "lhp": 0,
    "mowas": 3,
    "police": 0
  },
  "highest_severity": "moderate",
  "language": "en",
  "matched_count": 7,
  "minimum_severity": "",
  "sources": [
    "mowas",
    "katwarn",
    "biwapp",
    "dwd",
    "lhp",
    "police"
  ],
  "total_count": 7,
  "warnings": [
    {
      "event_code": "",
      "expires": "2026-10-22T20:00:00+02:00",
      "headline": "Amtliche WARNUNG vor STURMB\u00d6EN",
      "id": "dwdmap.2.49.0.0.276.0.DWD.PVW.1792592700000.e387dae9-aae8-4d2e-9e84-e334c4e3bc22.MUL",
      "is_all_clear": false,
      "msg_type": "Alert",
      "sent": "2026-10-21T16:25:00+02:00",
      "severity": "moderate",
      "source": "dwd",
      "source_name": "Weather (DWD)",
      "title": "Official WARNING of GALE-FORCE GUSTS",
      "urgency": "immediate",
      "version": 21
    },
    {
      "event_code": "BBK-EVC-079",
      "expires": "",
      "headline": "Erneute Sperrung der B27: Kampfmittelbeseitigung am 22. Oktober - G\u00f6ttingen",
      "id": "mow.DE-NI-GOE-W264-20261021-000",
      "is_all_clear": false,
      "msg_type": "Alert",
      "sent": "2026-10-21T14:45:32+02:00",
      "severity": "minor",
      "source": "mowas",
      "source_name": "Civil protection (MoWaS)",
      "title": "Second World War bomb",
      "urgency": "immediate",
      "version": 21
    }
  ]
}
```
