Skip to main content
GET
One vessel's track over time

Authorizations

Authorization
string
header
required

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

Path Parameters

imo
string
required

IMO number of the vessel (e.g. 9006681).

Query Parameters

date_start
string

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

date_end
string

Window end YYYY-MM-DD.

days
integer

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

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

Position points per page (1–5000).

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

Opaque keyset cursor on (time, mmsi). Pass back a prior response's next_cursor to fetch the next page; do not request one giant response.

Response

A page of the vessel's raw position track, time-ordered ascending. Envelope: { success, imo, data, pagination, applied_filters }. Each data row: time, mmsi, lat, lon, sog, cog, heading, nav_status, chokepoint. pagination.next_cursor is an opaque token — follow it to page through a long window.

success
boolean
imo
string
data
object[]
pagination
object
applied_filters
object