GETAPI key

Vessel photo

GETapi.navo24.com/v1/vessel/photo

Photo link for a ship by IMO. photo_url is a path on https://api.navo24.com (for example https://api.navo24.com/vphoto/9811000.jpg).

Query parameters

imostringrequired

IMO number, 7 digits.

Response schema

3 fields

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

dataobject

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

imostring

IMO number of the vessel.

photo_urlstring

Photograph of the hull. Null when we hold none.

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.

invalid_imo400

IMO number does not have 7 digits.

curl 'https://api.navo24.com/v1/vessel/photo?imo=9811000' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/vessel/photo?imo=9811000", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/vessel/photo?imo=9811000",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": {
    "imo": "9811000",
    "photo_url": "/vphoto/9811000.jpg?v=1793427902"
  }
}