Watching

Watched vessels

The vessels your account watches, the same list as on your dashboard: each with where she is now (alongside, at anchor, under way or not heard, places by name) and what happened in the last 7 days: anchored, all fast, sailed, weighed anchor and left an anchorage, not heard and heard again, destination and name changes as reported. POST a JSON body {"mmsi": 244000777, "label": "On hire"} to add a vessel (within your plan's number of vessels), DELETE ?mmsi= to stop watching her. Sign in once on the dashboard with your key's email to use it.

Reports included with a watch plan

On the Plus watch plan the AIS call timeline and on Pro and Custom also the port call summary and vessel history up to 90 days, for a vessel on your watch list cost no credits up to 90 days back, whenever you added her, through the API and on the dashboard. Vessel changes a month are limited (Plus 10, Pro 50, Custom agreed). Longer histories and port reports for what you watch come within a monthly allowance (10 on Pro); other reports are 20 % off on Plus and 30 % off on Pro. A Data API plan on its own pays the credits in the table. Each report still carries its verification code.

After a move to a smaller plan, or when a plan ends, nothing is deleted: the vessels above the new plan's number are marked paused (the newest first) and get no alerts and no included reports until you upgrade or remove some; they resume by themselves.

Parameters

Name	Description
mmsi integer	POST body or DELETE query: nine digits.
label string	POST body: your own name for her, up to 60 characters.

curl "https://gangwayais.com/v1/watch" \
  -H "Authorization: Bearer $GANGWAY_KEY"

{
  "limit": 5,
  "used": 1,
  "vessels": [
    {
      "mmsi": 244000777,
      "label": "On hire",
      "name": "EXAMPLE CARRIER",
      "type": "Cargo vessel",
      "added_at": "2026-10-28T09:12:00Z",
      "status": {
        "kind": "all_fast",
        "text": "All fast at Hutchison Ports ECT Delta, Rotterdam",
        "since": "2026-11-01T04:20:00Z",
        "place": "Hutchison Ports ECT Delta",
        "port": {
          "code": "NLRTM",
          "name": "Rotterdam"
        }
      },
      "last_heard": "2026-11-01T12:58:00Z"
    }
  ],
  "events": [
    {
      "mmsi": 244000777,
      "kind": "all_fast",
      "time": "2026-11-01T04:20:00Z",
      "text": "All fast at Hutchison Ports ECT Delta, Rotterdam",
      "place": "Hutchison Ports ECT Delta",
      "port": {
        "code": "NLRTM",
        "name": "Rotterdam"
      }
    }
  ],
  "note": "Places by name; no positions. Reports for a watched vessel are included on the Plus, Pro and Custom watch plans."
}