Tides API: FES2022 tide predictions
The Tides API predicts astronomical tide heights for any coastal or offshore point on Earth. It doesn't fall back to the nearest tide station, which may be 40 km away. Predictions are computed from FES2022, the latest generation of the CNES/LEGOS/NOVELTIS/CLS global tide atlas (34 constituents on a 1/30° grid, assimilating three decades of altimetry), distributed by AVISO.
Because it is a model, any date works. Reconstructing the past and planning far ahead each take the same single call.
Endpoint auth: API key (Authorization: Bearer tt_live_…)
Postman: import the
collection
and the
environment
(Postman's Import dialog accepts both links), set apiKey, and you're
ready. The collection covers every thirdtrail API.
GET /v1/tides/heights/
Water-height time series relative to mean sea level.
| Param | Required | Notes |
|---|---|---|
lat, lon |
yes | decimal degrees |
start_date |
no | YYYY-MM-DD, default today (UTC). Past dates need a paid plan |
days |
no | window length; plan-capped |
step |
no | 1m 5m 10m 15m 30m 1h, default 10m; finest step is plan-gated |
datum |
no | msl (default) or lat (Lowest Astronomical Tide, Pro+) |
tz / utc_offset / auto_timezone |
no | output timezone |
curl -H "Authorization: Bearer tt_live_…" \
"https://thirdtrail.life/v1/tides/heights/?lat=48.383&lon=-4.495&days=2&step=30m"
{
"resolved": {"model": "FES2022B", "timezone": "UTC", "datum": "MSL"},
"heights": [
{"time": "2026-07-25T00:00:00+00:00", "height_m": -1.891},
{"time": "2026-07-25T00:30:00+00:00", "height_m": -1.634}
]
}
GET /v1/tides/extremes/
High and low waters (times and heights), refined to the second with a
parabolic fit.
Same parameters as /heights/ minus step.
GET /v1/tides/window/ (Starter+)
The coastal planning call. For each day it returns the tide extremes plus sunrise, sunset, twilight, golden and blue hour, and moon phase from our ephemerides engine, so you need one request instead of two products. It's meant for photographers, anglers, drone pilots and shore crews.
Same parameters as /extremes/, plus:
| Param | Required | Notes |
|---|---|---|
elevation |
no | metres above sea level, −500 to 9000. Applies to the sun and moon only |
auto_elevation |
no | derive it from lat / lon (Pro+) |
Elevation matters here for the same reason it does everywhere else in thirdtrail: the higher you stand, the earlier the sun clears the horizon. On top of a 214 m sea cliff, sunrise is about three minutes earlier than at the water's edge, and every golden- and blue-hour boundary moves with it. That is a noticeable share of a window only 20 to 40 minutes long.
Tide heights are not affected. How high the observer stands has no
bearing on the ocean surface, which is why /heights/ and /extremes/
have no elevation parameter. resolved.elevation_m and resolved.elevation_source (user, auto
or default) report what was actually applied.
GET /v1/tides/constituents/ (Pro+)
The 34 harmonic constants (amplitude, Greenwich phase lag, angular speed) interpolated at your point. Use them to compute offline, check our numbers, or feed your own synthesis.
POST /v1/tides/bulk/ (Pro+)
{"queries": [{"lat": …, "lon": …, "days": …}, …]} → extremes for up to
100 (Pro) / 1,000 (Business) locations per request.
Datums
Heights default to MSL. datum=lat (Pro+) re-references to Lowest
Astronomical Tide computed from a full 18.6-year nodal scan at your exact
point, and the response carries LAT/HAT/MHWS/MLWS offsets so you can
re-reference to chart datum yourself.
Accuracy & limitations
- Astronomical tide only: no meteorological surge and no river discharge.
- FES2022 is noticeably more accurate near the coast than FES2014 (finer mesh, better bathymetry, more assimilated data). Open-ocean accuracy is about 1 cm RMS; complex shelf areas are still harder for any global model.
- Harbours, estuaries and sounds can be far out. A global model cannot follow the tide up a narrow channel. Against NOAA's predictions for October 2026, our high and low waters were within 3 to 7 minutes on open coasts, and 45 to 60 minutes early at Seattle, at the Battery in New York and at Galveston. If your point is behind a narrow entrance, check it against a local tide table before relying on it.
- Where the tidal range is under about half a metre, the time of high or low water is poorly defined and can differ by 20 minutes or more between any two predictions.
- Our synthesis engine is validated constituent-by-constituent against
CNES's own
pyfesreference (equilibrium arguments to <0.2°, nodal factors to <0.3%). - Not for navigation. See our safety page.
FES2022 was produced by LEGOS, NOVELTIS and CLS, funded by CNES, and is distributed by AVISO.