Skip to content
Developer docs: all pages

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

Parameters
NameInDescription
id(required)pathA checksum-valid IMO number, or "mmsi-" plus the 9-digit MMSI for craft without one.
Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/vessels/9811000
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"
}