GETAPI key

Find a port

GETapi.navo24.com/v1/dd/ports

Port autocomplete by name or UN/LOCODE, at least 2 characters.

Query parameters

qstringrequired

Port name or code.

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.

data[]object

unlocodestring

UN/LOCODE port code. On a tracking event it is canonicalised, and null when the carrier named no port.

namestring

Human-readable name.

country_codestring

ISO 3166-1 alpha-2 country code.

Errors

A failure carries { "error": { "code", "message" } } with the HTTP status. Branch on the code, and log the message.

invalid_key401

The key is unknown or revoked.

rate_limited429

More than 60 requests in one minute from one key.

curl 'https://api.navo24.com/v1/dd/ports?q=rotter' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/dd/ports?q=rotter", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/dd/ports?q=rotter",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "unlocode": "USRAJ",
      "name": "Rotterdam",
      "country_code": "US"
    },
    {
      "unlocode": "NLRTM",
      "name": "Rotterdam",
      "country_code": "NL"
    },
    {
      "unlocode": "USRJN",
      "name": "Rotterdam Junction",
      "country_code": "US"
    }
  ]
}