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.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Restrict to one chokepoint. Omit for all.
hormuz, bab_el_mandeb, malacca, suez, panama, bosphorus, gibraltar, dover, kerch, taiwan, danish_straits 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.
ongoing, completed Departure-window start YYYY-MM-DD (≤30-day window).
Departure-window end YYYY-MM-DD.
Trailing N-day window (1–30). Defaults to 7.
1 <= x <= 30Rows per page (1–500).
1 <= x <= 500Pagination cursor (offset) from a prior response's next_cursor.