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
| Name | In | Description |
|---|---|---|
| unlocode(required) | path | Five-character UN/LOCODE. |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/ports/nlrtmResponse (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"
}