Sign in

v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Maritime

Chokepoint dwell episodes

Dwell episodes — completed arrival→departure stays at maritime chokepoints, derived from terrestrial AIS. Each row is one vessel's stay with its dwell duration. Requires a plan with Maritime intelligence access (can_use_maritime) — the Corporate & Supply Chain plan and above.

Forward-accruing: episodes begin accruing at launch (June 2026) — no historical backfill. Derived-only: no raw position track. Terrestrial AIS only (no satellite). Filtered by departure time; date windows are capped at 30 days and default to the trailing 7 days.

get/api/v2/maritime/dwell

Query parameters

chokepoint'hormuz' | 'bab_el_mandeb' | 'malacca' | 'suez' | 'panama' | 'bosphorus' | 'gibraltar' | 'dover' | 'kerch' | 'taiwan' | 'danish_straits'

Restrict to one chokepoint. Omit for all.

status'ongoing' | 'completed'

ongoing = the vessel is still inside the chokepoint at the rollup edge (its dwell_hours is elapsed-so-far and departure is an as-of timestamp, not final); completed = the vessel has departed. Omit for both. An unknown value returns 400 INVALID_ENUM.

date_startstring

Departure-window start YYYY-MM-DD (≤30-day window).

date_endstring

Departure-window end YYYY-MM-DD.

daysinteger

Trailing N-day window (1–30). Defaults to 7.

limitinteger

Rows per page (1–500).

cursorstring

Pagination cursor (offset) from a prior response's next_cursor.

Response

A page of dwell episodes, by departure time (most recent first). Each row: imo, mmsi, chokepoint, arrival, departure, dwell_hours. Standard envelope: { success, data, pagination, applied_filters }.

successboolean