Sign in

v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Maritime

Raw position points in an area

⚠️ RAW position points (the actual AIS track) inside an area over time — each row a single fix (time, position, speed, course, nav status). AREA REQUIRED — pass chokepoint, bbox, near, or near_gem_id. Keyset-paginated: follow the opaque next_cursor to stitch a long window into pages rather than one giant response. Requires a plan with Maritime intelligence access (can_use_maritime) — the Corporate & Supply Chain plan and above.

Historical / baseline surface: reads raw AIS positions directly. Forward-accruing: positions begin at launch (June 2026) — no historical backfill. Terrestrial AIS only (no satellite). Date windows are capped at 7 days; defaults to the trailing 1 day.

get/api/v2/maritime/tracks

Query parameters

chokepoint'hormuz' | 'bab_el_mandeb' | 'malacca' | 'suez' | 'panama' | 'bosphorus' | 'gibraltar' | 'dover' | 'kerch' | 'taiwan' | 'danish_straits'

One chokepoint as the area. One of chokepoint / bbox / near / near_gem_id is required.

bboxstring

Bounding box filter: minLon,minLat,maxLon,maxLat (lon-first axis order). One of chokepoint / bbox / near / near_gem_id is required.

nearstring

Point 'lat,lon' for a radius area; combine with radius_km (default 50 km). Rows include distance_km. One of chokepoint / bbox / near / near_gem_id is required.

near_gem_idstring

GEM energy-asset gem_id center — points within radius_km of that asset (default 25 km). Rows include distance_km. One of chokepoint / bbox / near / near_gem_id is required.

radius_kmnumber

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

date_startstring

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

date_endstring

Window end YYYY-MM-DD.

daysinteger

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

limitinteger

Position points per page (1–5000).

cursorstring

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 raw position points, time-ordered ascending. Envelope: { success, data, pagination, applied_filters }. Each data row: time, mmsi, imo, lat, lon, sog, cog, nav_status, chokepoint, and distance_km (km from the near / near_gem_id center, only when one is set). pagination.next_cursor is an opaque token — follow it to page through a long window.

successboolean