Neptun·

Navigational warnings

Official notices to mariners from 106 sources.

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

NameTypeDescription
bboxstring, optionalArea as minLat,minLon,maxLat,maxLon
latnumber, optionalLatitude (−90…90)
lonnumber, optionalLongitude (−180…180)
radiusnumber, optionalRadius in km (when using lat/lon)
langstring, optionalLanguage (de · en) of the notice texts or the attribution
sourcestring, optionalFilter by source, comma-separated
closed_onlyboolean, optionalclosures only
sinceinteger, optionalonly changes since this Unix timestamp
limitinteger, optionalresults per call — default 200, maximum 1000
offsetinteger, optionalpaging: pass `next_offset` from the previous response while `has_more` is true
exact_onlyboolean, optionalonly 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": { … } }