Skip to main content
GET
Chokepoint dwell episodes

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

chokepoint
enum<string>

Restrict to one chokepoint. Omit for all.

Available options:
hormuz,
bab_el_mandeb,
malacca,
suez,
panama,
bosphorus,
gibraltar,
dover,
kerch,
taiwan,
danish_straits
status
enum<string>

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.

Available options:
ongoing,
completed
date_start
string

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

date_end
string

Departure-window end YYYY-MM-DD.

days
integer

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

Required range: 1 <= x <= 30
limit
integer
default:100

Rows per page (1–500).

Required range: 1 <= x <= 500
cursor
string

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 }.

success
boolean
data
object[]
pagination
object
applied_filters
object