Skip to content
Developer docs: all pages

GET/api/v1/vessels/{id}/port-calls

A vessel's port calls

The vessel's port calls in a date window, newest first, in one list merging authority-reported calls (evidenceClass `reported`: port-authority and customs records such as Digitraffic Portnet, Hong Kong Marine Department and USACE entrances and clearances, with `source`, berth, time precision, previous and next port, draft and how the record was matched to the ship) and AIS-detected calls (evidenceClass `derived`, with `method` and `methodVersion`). Each row is served only when its own source permits API use; rows that do not are counted under `withheld` by source for the page. AIS-detected calls are withheld as a section while the detector's rights are conditional. The window may reach back as far as your plan's history (the last 24 hours on every plan; free sign-in connections and Developer 30 days, Plus 365 days, Growth 2 years, Pro and Scale everything); further is 403 history_not_in_plan. Duplicate reports of one call are folded within a page.

1 creditKey required

Parameters
NameInDescription
id(required)pathA checksum-valid IMO number, or "mmsi-" plus the 9-digit MMSI.
daysqueryThe last N days, 1 to 366 (default 30). Not with from/to.
fromqueryWindow start (ISO 8601), as far back as your plan allows.
toqueryWindow end (ISO 8601, default now); the window is at most 366 days.
limitqueryRows per page, 1 to 100 (default 50).
cursorqueryOpaque cursor: use the "next" URL of the previous page.
Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/vessels/9811000/port-calls?days=30
Response (abridged)
{
  "type": "vessel_port_calls",
  "apiVersion": "1",
  "imo": 9811000,
  "mmsi": …,
  "name": "EVER GIVEN",
  "window": { "from": "2026-10-03T12:00:00.000Z", "to": "2026-11-02T12:00:00.000Z" },
  "count": 1,
  "data": [
    { "evidenceClass": "reported", "source": "digitraffic_portcalls", "unlocode": "FIHEL", "port": "Helsinki",
      "berth": "…", "arrival": "2026-10-29T22:35:00.000Z", "departure": "2026-10-30T05:21:00.000Z",
      "timePrecision": "minute", "previousPort": "EETLL", "nextPort": "EETLL", "draftM": 7.1,
      "match": { "method": "imo", "confidence": 1 } }
  ],
  "next": null,
  "withheld": [
    { "section": "reportedPortCalls", "sources": ["barcelona_portcalls"], "rows": 1, "reason": "source_not_licensed_for_api" },
    { "section": "aisPortCalls", "sources": ["seadar_portcall_detector"], "reason": "source_not_licensed_for_api" }
  ],
  "attribution": [ "…" ], "license": [ "CC BY 4.0" ], "sources": ["digitraffic_portcalls"]
}