GETAPI key

Open AIS snapshot

GETapi.navo24.com/v1/vessel/ais-open

Snapshot of open AIS feeds (Fintraffic Digitraffic CC BY 4.0, aisstream.io), cached 5 minutes: [mmsi, name, lat, lng, heading, speed_knots, ship_type, fix_unix, imo]. Two rows shown.

Response schema

4 fields

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

dataobject

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

atnumber

sourcestring

Where the answer on this call came from: direct_carrier or warm_db.

vesselsnumber[][]

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.

curl 'https://api.navo24.com/v1/vessel/ais-open' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/vessel/ais-open", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/vessel/ais-open",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": {
    "at": 1793602219,
    "source": "Fintraffic Digitraffic (CC BY 4.0), aisstream.io",
    "vessels": [
      [
        230980380,
        "POLLUX",
        65.0052,
        25.4265,
        46,
        0.0,
        "Other",
        1793601999,
        ""
      ],
      [
        276013230,
        "SAR SLAVA KAESI",
        59.6472,
        25.7538,
        360,
        0.1,
        "Special craft",
        1793601643,
        ""
      ]
    ]
  }
}