v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Maritime

AIS-dark gaps

AIS-dark gaps — intervals where a vessel stopped broadcasting AIS then reappeared, derived from terrestrial AIS coverage. Each row is one gap with the last-known position before it went dark. Requires a plan with Maritime intelligence access (can_use_maritime) — the Corporate & Supply Chain plan and above.

Forward-accruing: gaps begin accruing at launch (June 2026) — no historical backfill. Terrestrial AIS only (no satellite); a gap reflects loss of terrestrial reception, not necessarily a deliberate dark event. Filtered by gap-end time; date windows are capped at 30 days and default to the trailing 7 days.

get/api/v2/maritime/gaps

Query parameters

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

Restrict to gaps whose last-known chokepoint is this one. Omit for all.

min_gap_hoursnumber

Minimum gap duration in hours. Defaults to 6.

date_startstring

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

date_endstring

Gap-end-window end YYYY-MM-DD.

daysinteger

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

limitinteger

Rows per page (1–500).

cursorstring

Pagination cursor (offset) from a prior response's next_cursor.

Response

A page of AIS-dark gaps, longest first. Each row: imo, mmsi, gap_start, gap_end, gap_hours, last_lat, last_lon, chokepoint (last-known before going dark). Standard envelope: { success, data, pagination, applied_filters }.

successboolean