v1
latestOpenAPI 3.0.32026-07-226744340.8 KBCurrent vessels (last-known)
Current vessels with their last-known position and identity, derived from terrestrial AIS. Positions are LAST-KNOWN ONLY — there is no raw position-track endpoint. This is current state, so it takes no date window. Requires a plan with Maritime intelligence access (can_use_maritime) — the Corporate & Supply Chain plan and above.
Forward-accruing: vessel state begins at launch (June 2026). Terrestrial AIS only (no satellite).
Query parameters
Restrict to vessels whose last-known position is in this chokepoint. Omit for all.
Search vessels by name (case-insensitive substring, ngram-indexed), IMO, MMSI, or call sign.
Bounding box filter: minLon,minLat,maxLon,maxLat (e.g. 103,1,105,2).
Point 'lat,lon' for a radius search; combine with radius_km. Results include distance_km, sorted nearest-first.
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 in km for near / near_gem_id. Default 50 (near) or 25 (near_gem_id); clamped 1–2000.
Rows per page (1–500).
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 }.