GET /v1/warnings
Scope: notices
Notices to mariners, navigational warnings, closures and works — from 106 national services, geolocated, de-duplicated and translated on request. Exactly the work you would otherwise repeat for every country. Since 29 Oct 2026 every notice carries three normalised fields across all sources: `kind` (e.g. closure, works, event, military_exercise, search_and_rescue), `validity` (fixed = has an end date, indefinite = until further notice) and `position` — where the coordinate comes from: exact (published by the source), text (read from the notice text), waterway_km (inland waterway kilometre), seamark (placed on the aid to navigation), place (place-name lookup), area (area centre), water (moved into the nearest water), none. `category` is unchanged. `valid_from` is the start date stated by the source — if the source gives none, the field is null. Larger areas: use `limit` up to 1000 and page with `next_offset` while `has_more` is true. Since 15 Nov 2026 every notice carries `geometry`: a GeoJSON Polygon or MultiPolygon when the authority gives corner points, a box or a radius (restricted and warning areas), otherwise `null`. Neptun Boating keys (Neptun K-Boating and P-Boating, see /plotter/) query by vessel position only (`lat`+`lon`, radius up to 200 km) and receive the notices of their bound regions; the response carries `plotter` with the region, the bound regions and the limit. When the limit is reached the API answers `403` with `detail.error = region_limit`. The sea region at the position is the one bound; inland regions there are included without counting (`plotter.included`), and so are notices from neighbouring regions within 3 nm of the position (`plotter.nearby_nm`). Responses to Neptun Boating keys carry an `ETag`; send `If-None-Match` to get `304` without a body when nothing changed.
Parameters
| Name | Type | Description |
|---|---|---|
bbox | string, optional | Area as minLat,minLon,maxLat,maxLon |
lat | number, optional | Latitude (−90…90) |
lon | number, optional | Longitude (−180…180) |
radius | number, optional | Radius in km (when using lat/lon) |
lang | string, optional | Language (de · en) of the notice texts or the attribution |
source | string, optional | Filter by source, comma-separated |
closed_only | boolean, optional | closures only |
since | integer, optional | only changes since this Unix timestamp |
limit | integer, optional | results per call — default 200, maximum 1000 |
offset | integer, optional | paging: pass `next_offset` from the previous response while `has_more` is true |
exact_only | boolean, optional | only notices with a precise position (excludes area/place-only ones, `coarse`) |
Example response
{ "count": 1, "warnings": [ { "id": "nfb-2026/2623", "source": "elwis", "regions": ["de-binnen"],
"lat": 53.27442, "lon": 12.98869, "coarse": false, "place": "Schleuse Wesenberg",
"fairway": "Obere Havel-Wasserstraße, km 81,7–81,8", "detail": "…",
"category": "closure", "kind": "water_level", "validity": "fixed", "position": "waterway_km",
"closed": true, "valid_from": 1789084800, "valid_until": 1796083199, "link": "…",
"geometry": null } ],
"attribution": "…", "quota": { … } }