Skip to main content
GET
Current vessels (last-known)

Authorizations

Authorization
string
header
required

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

Query Parameters

chokepoint
enum<string>

Restrict to vessels whose last-known position is in this chokepoint. Omit for all.

Available options:
hormuz,
bab_el_mandeb,
malacca,
suez,
panama,
bosphorus,
gibraltar,
dover,
kerch,
taiwan,
danish_straits

Search vessels by name (case-insensitive substring, ngram-indexed), IMO, MMSI, or call sign.

bbox
string

Bounding box filter: minLon,minLat,maxLon,maxLat (e.g. 103,1,105,2).

near
string

Point 'lat,lon' for a radius search; combine with radius_km. Results include distance_km, sorted nearest-first.

near_gem_id
string

GEM energy-asset gem_id (resolved via gem.assets_view) — returns vessels within radius_km of that LNG terminal / platform / port. The cross-source 'vessels near energy infrastructure' join.

radius_km
number

Radius in km for near / near_gem_id. Default 50 (near) or 25 (near_gem_id); clamped 1–2000.

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 vessels, most recently seen first (or nearest-first when near / near_gem_id is set). Each row: mmsi, imo, name, ship_type, ship_type_code, flag (ISO-3), call_sign, length_m, width_m, draught_m, lat, lon, chokepoint, sog (speed over ground, knots), last_time, gem_id (Global Energy Monitor link when matched), and distance_km (km from the near / near_gem_id center, only present when one is set). Standard envelope: { success, data, pagination, applied_filters }.

success
boolean
data
object[]
pagination
object
applied_filters
object