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
| Name | In | Description |
|---|---|---|
| id(required) | path | A checksum-valid IMO number, or "mmsi-" plus the 9-digit MMSI. |
| days | query | The last N days, 1 to 366 (default 30). Not with from/to. |
| from | query | Window start (ISO 8601), as far back as your plan allows. |
| to | query | Window end (ISO 8601, default now); the window is at most 366 days. |
| limit | query | Rows per page, 1 to 100 (default 50). |
| cursor | query | Opaque cursor: use the "next" URL of the previous page. |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/vessels/9811000/port-calls?days=30Response (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"]
}