GET /v1/tides
Scope: tides
Where an official station lies within 20 km, its prediction is used: LINZ in New Zealand (88 standard ports, 273 secondary ports), NOAA in the United States (about 3,500 stations, datum MLLW), Rijkswaterstaat in the Netherlands (87, datum NAP) and BSH on the German North Sea coast (82, datum LAT). BSH predicts about six days ahead; the model takes over after that, every extreme names its source and `official_from`/`model_from` mark the switch. `source` names the source, `station` gives name, kind and distance, `datum` the height reference. Everywhere else the FES2022b harmonic model computes the exact position you ask for (`source`: fes, datum LAT); `source=model` forces the model. Where the model does not resolve a bay and we have checked it against published times, we correct it and say so in `correction` (Rade de Brest: high water +28 min); where that is not possible you get `confidence: low` with `limitation` (Seine estuary). Returns the current level, the trend and the upcoming extremes.
Parameters
| Name | Type | Description |
|---|---|---|
lat | number, required | Latitude (−90…90) |
lon | number, required | Longitude (−180…180) |
days | integer, optional | Forecast horizon in days |
lang | string, optional | Language (de · en) of the notice texts or the attribution |
source | string, optional | Filter by source, comma-separated |
Example response
{
"ok": true, "source": "noaa", "confidence": "official", "datum": "MLLW",
"station": { "id": "noaa-8518750", "name": "NEW YORK (The Battery)", "kind": "standard", "dist_km": 0.5 },
"now": 0.42, "trend": "falling", "extremes": [ { "ts": 1794560880, "typ": "NW", "hoehe": 0.28 } ],
"attribution": "Tide predictions: NOAA CO-OPS …",
"quota": { "used": 3, "limit": 50000, "remaining": 49997 }
}