GETAPI key

Find a vessel

GETvessel.navo24.com/v1/vessel/search

Name or IMO search in the Navo vessel index: container ships the carriers publish in their schedules, with TEU, flag, year built, length and operators.

Query parameters

qstringrequired

Part of the vessel name (2+ letters) or the 7-digit IMO.

Response schema

9 fields

Derived from the example response, nested as the JSON is.

dataobject[]

The payload. Everything an endpoint returns sits under this key.

data[]object

imostring

IMO number of the vessel.

namestring

Human-readable name.

carriersstring[]

Carriers, ranked.

teunumber

Vessel capacity in TEU.

teu_estimatedboolean

True when the TEU figure is derived rather than published.

flagstring

Flag state of the vessel, as a two-letter code. Null when we hold none.

year_builtnumber

Year the hull was delivered.

length_mnumber

Overall length in metres.

Errors

A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.

missing_key401

No key in Authorization or x-api-key.

invalid_key401

The key is unknown or revoked.

rate_limited429

More than 40 requests in one minute from one client.

upstream_error502

A source did not answer. Retry in a minute.

curl 'https://vessel.navo24.com/v1/vessel/search?q=EVER%20GIVEN' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://vessel.navo24.com/v1/vessel/search?q=EVER%20GIVEN", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://vessel.navo24.com/v1/vessel/search?q=EVER%20GIVEN",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "imo": "9811000",
      "name": "EVER GIVEN",
      "carriers": [
        "CMA CGM",
        "COSCO",
        "Evergreen",
        "OOCL"
      ],
      "teu": 20124,
      "teu_estimated": false,
      "flag": "Panama",
      "year_built": 2018,
      "length_m": 400
    }
  ]
}