Skip to main content
GET
AIS-dark gaps

Authorizations

Authorization
string
header
required

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

Query Parameters

chokepoint
enum<string>

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

Available options:
hormuz,
bab_el_mandeb,
malacca,
suez,
panama,
bosphorus,
gibraltar,
dover,
kerch,
taiwan,
danish_straits
min_gap_hours
number
default:6

Minimum gap duration in hours. Defaults to 6.

Required range: x >= 0
date_start
string

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

date_end
string

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

days
integer

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

Required range: 1 <= x <= 30
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 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 }.

success
boolean
data
object[]
pagination
object
applied_filters
object