Gangway AISGangway AISby Motto Marine International
DOCS · API v1
CoverageHomeSign inGet API key
Reports

Vessel historyGANGWAY ONLY

GET/v1/vessels/{mmsi}/history15,000 (over 90 days of what we hold for the vessel 20,000) credits

One vessel over a window, as a printable report: her calls with time at anchor and alongside, hours at sea, at anchor, alongside and not heard, miles under way, the ports and regions she traded between, name and destination changes as reported and the OFAC, UK and EU sanctions lists matched by IMO number only. A period not heard is a time our sources did not receive her; it does not by itself show that her AIS was switched off. Our recorded history begins on 7 October 2026: a longer window is cut to it, the report says so and the credits follow the days covered. It costs nothing when there is nothing to report. For a vessel on your list on a Pro or Custom watch plan it costs nothing up to 90 days back, whenever you added her. A window of over 90 days of what we hold is a longer history: those plans include some each month for the whole window (Pro 10, Custom agreed). Past those, only the days beyond the first 90 pay; the preview shows the number first and max_credits refuses anything above it. Our record begins on 7 October 2026 so none can run over 90 days before January 2027. format=html gives the printable page with its verification code (print it to PDF).

Free preview

Add /preview for the key figures and how well our sources heard it: no credits, 60 an hour. Full reports are for paid plans; on the free API allowance the full report answers 402 paid_plan_required with the address of its free preview.

Parameters

NameDescription
mmsirequired
integer
In the path.
days
integer
Up to 90 on Plus, 365 on Pro and Scale. On a Pro or Custom watch plan a vessel you watch reaches the whole record, for a longer history. Default 90.
max_credits
integer
Optional. Refuses with 402 and no charge if the answer would cost more.
format
json | html
Default json.
curl "https://gangwayais.com/v1/vessels/244000777/history?days=90" \
  -H "Authorization: Bearer $GANGWAY_KEY"
{
  "kind": "vessel_history",
  "vessel": {
    "mmsi": 244000777,
    "name": "EXAMPLE CARRIER",
    "type_group": "cargo",
    "length": 180
  },
  "window": {
    "asked_days": 90,
    "days": 25.4,
    "from": "2026-10-07T00:00:00Z",
    "to": "2026-11-01T09:00:00Z",
    "note": "Our recorded history begins on 2026-10-07 so this report covers 25 days rather than the 90 asked for."
  },
  "hours": {
    "at_sea": 168.1,
    "at_anchor": 150.3,
    "alongside": 250.7,
    "not_heard": 39.9
  },
  "nm_under_way": 1797,
  "trade_pattern": [
    "North Europe"
  ]
}