GET/api/v1/vessels/{id}
A vessel
The vessel page as JSON, each section (or row) included only when its source permits API use. `inspections`: USCG PSIX exams and UK MCA Paris MOU detentions, gated per row on the row's source, with date, type, port, status, `detained` and `deficiencyCount` (null where the source did not record them, never a false clean) and, for UK MCA detentions, `detention` (release date, grounds, detainable deficiencies, classification society, the GOV.UK list). `emissions`: EU MRV verified annual reports (CO2, fuel, time at sea, CO2 per nautical mile, EU ETS CO2, CH4, N2O, CO2e, EEXI/EEDI). `emissionsBenchmark`: Voydar's calculation from those figures for the newest reporting year (`derived: true`, evidenceClass calculated, with method, version, inputs and attribution): the percentile of the ship's CO2 per nautical mile, and per tonne-nautical mile of transport work where reported, among ships of the same EU MRV ship type and year (share of peers with a lower figure; lower is better), with the peer count and the group's quartiles. It is not a rating and not the IMO CII. `sanctions`: current and delisted designations (`status` active or delisted) with list, programme, dates and source link, gated per row on the list's own rights. `reportedPortCalls`: the 12 newest authority-reported calls on record, however old, each with `recent` (its date is within 90 days), and `reportedPortCallsPeriod` (`latest`, `earliest`, `recentCalls`, per-source dates, and `historical: true` when none is recent); `aisPortCalls` (AIS-detected, evidenceClass derived, method seadar_portcall_detector) is served per call: only calls whose every input feed permits API use (calls with unrecorded inputs are withheld). Dated port-call history: /api/v1/vessels/{id}/port-calls.
1 creditWorks without a key
| Name | In | Description |
|---|---|---|
| id(required) | path | A checksum-valid IMO number, or "mmsi-" plus the 9-digit MMSI for craft without one. |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/vessels/9811000Response (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"
}