Skip to content
Developer docs: all pages

GET/api/v1/ports/{unlocode}

A port

The port page as JSON, by UN/LOCODE (case-insensitive): location, harbour (NGA World Port Index), `navigationalWarnings`, `reportedPortCalls` and `aisActivity` (AIS-derived aggregates: ships in port now, arrivals and departures in 24 hours, calls in 7 and 30 days, distinct ships in 30 days, with method and version; withheld while the AIS port-call detector's rights are conditional). `reportedTurnaround` (where the port authority publishes calls timed to the minute; today Finnish ports): time in port as calculated by Voydar for the newest complete month, per ship-type group as the authority reports it (cargo, tanker, passenger and ferry, other) with calls, p10, median and p90 in hours (`derived: true`, evidenceClass calculated, with method, version, inputs and attribution). An all-ships row appears only where passenger ships and ferries are under 5 % of the calls; otherwise `allShipsWithheld` is true. No AIS is read. `reportedArrivalsByOrigin` (same ports; `scope: country`): reported arrivals in the country of the port by the country of the previous port, a count of reports from the ports that publish, not all traffic. `navigationalWarnings`: warnings within 100 km that were in force when their issuer's list was last loaded (NGA MSI, AMSA NAVAREA X), each with `source`, `asOf` (the start of that load), `stale` (true when the load is older than the source's freshness limit, or its age could not be confirmed) and `freshness` (`fresh`, `stale` or `unknown`). A stale warning may have been cancelled or replaced since `asOf`: show the date and do not present it as in force. `reportedPortCalls`: the 12 newest authority-reported calls on record, however old; they are not recent activity unless dated so. Each call carries `recent` (its date is within 90 days) and `reportedPortCallsPeriod` gives `latest`, `earliest`, `recentCalls`, `recentWindowDays`, the same per publishing source under `sources`, and `historical: true` when no call returned is recent (for example US ports whose only record is USACE entrances and clearances ending in 2016). Dated call history: /api/v1/ports/{unlocode}/port-calls.

1 creditWorks without a key

Parameters
NameInDescription
unlocode(required)pathFive-character UN/LOCODE.
Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/ports/nlrtm
Response (abridged)
{
  "type": "vessel",
  "apiVersion": "preview",
  "page": "https://www.voydar.com/vessel/9811000-ever-given",
  "imo": 9811000,
  "mmsi": …,
  "name": "EVER GIVEN",
  "data": {
    "inspections": [
      { "date": "…", "type": "Port State Control detention", "port": "…", "source": "uk_mca_detentions", "detained": true,
        "deficiencyCount": 18, "detention": { "releasedOn": "…", "groundsCount": 12, "detainableDeficiencies": [ … ], "sourceLists": [ … ] } }
    ],
    "emissions": [ { "year": 2024, "co2T": …, "fuelT": …, "timeAtSeaH": …, "co2EtsT": …, "co2eqT": …, "source": "eu_mrv" } ],
    "sanctions": [],
    "companies": [ { "role": "registered_owner", "name": "…", "sources": ["eu_mrv"] } ]
  },
  "withheld": [
    { "section": "lastPosition", "sources": ["aisstream"], "reason": "source_not_licensed_for_api" },
    { "section": "particulars", "sources": ["seadar_legacy_vessels"], "reason": "source_not_licensed_for_api" }
  ],
  "attribution": [ "…" ],
  "license": [ "…" ],
  "sources": ["eu_mrv", "uscg_psix"],
  "generatedAt": "2026-09-23T12:00:00.000Z"
}