Neptun·

API reference

Neptun is a REST API for tides, tidal currents and European coastal data. All responses are JSON, all endpoints are read-only via GET.

Base URL & authentication

Base URL: https://neptun.marine-api.com/v1

Every request needs an API key (mapi_…) in the Authorization header (recommended) or as a ?key= parameter:

curl -H "Authorization: Bearer mapi_YOUR_KEY" \
  "https://neptun.marine-api.com/v1/tides?lat=54.32&lon=13.10"

Quotas

Quotas apply per calendar month (UTC). Every response carries a quota object. When the quota is used up the API answers 429; a short-term per-minute limit applies as well (120/min by default) and returns 429 with a Retry-After header. The free plan also has a daily limit of 100 calls per calendar day (UTC), per key and per connection; once reached, the API answers 429 with Retry-After until 00:00 UTC. /v1/me shows usage (used_month, on free also used_today) and costs no quota.

Attribution (required)

Every response carries an attribution field. Under the data providers' licences this credit must be carried through whenever you display or process the data. Model values — not for navigation.

Which networks and countries are covered?

Example clients (Python, Node)

Endpoints

Status

GET /v1/statusPublic module status, available without a key.
GET /v1/levels/statusGauge networks: coverage and freshness per network.
GET /v1/warnings/statusNotice sources: yield and freshness per source.
GET /v1/locks/statusLocks per country.