Skip to content
Developer docs: all pages

GET/api/v1/ports/{unlocode}/port-calls

Port calls at a port

Calls at one port in a date window, newest first, merging authority-reported calls (evidenceClass `reported`, with the vessel name as the source published it and the IMO/MMSI where Voydar matched the record to a ship) and AIS-detected calls (evidenceClass `derived`, with `method` and `methodVersion`). Rights, history depth and paging as for a vessel's port calls.

1 creditKey required

Parameters
NameInDescription
unlocode(required)pathFive-character UN/LOCODE.
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/ports/fihel/port-calls?days=7
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"]
}