GETAPI key

Container lines

GETapi.navo24.com/v1/dd/carriers

Lines we know, by SCAC. published is true when the line has a tariff in our data.

Response schema

7 fields

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

dataobject[]

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

data[]object

scacstring

namestring

Human-readable name.

slugstring

logostring

ranknumber

publishedboolean

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/carriers' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

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

import requests

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

Response

{
  "data": [
    {
      "scac": "MSCU",
      "name": "MSC",
      "slug": "msc",
      "logo": "/carriers/logos/msc.svg",
      "rank": 1,
      "published": true
    },
    {
      "scac": "MAEU",
      "name": "Maersk",
      "slug": "maersk",
      "logo": "/carriers/logos/maersk.png",
      "rank": 2,
      "published": true
    }
  ]
}