GETAPI key

Connected sources

GETapi.navo24.com/v1/parcel/sources

Every postal and courier source the tracker asks, with region, access method and status. Two of the list shown.

Response schema

8 fields

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

dataobject[]

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

data[]object

namestring

Human-readable name.

regionstring

methodstring

How the position was produced, for example route_reckoning.

authstring

free_limitstring

statusstring

Current normalised status of the shipment. Ocean lifecycle order: discharged, available, delivered, returned_empty. Two values end a shipment, delivered and returned_empty, and returned_empty outranks delivered.

notestring

One sentence of provenance in plain language.

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

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

import requests

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

Response

{
  "data": [
    {
      "name": "Nova Poshta",
      "region": "UA",
      "method": "API (JSON, public method getStatusDocuments)",
      "auth": "none (empty apiKey)",
      "free_limit": "no published limit",
      "status": "connected",
      "note": ""
    },
    {
      "name": "Cainiao Global (AliExpress, China Post, partner lines)",
      "region": "CN",
      "method": "JSON detail.json",
      "auth": "none",
      "free_limit": "no published limit",
      "status": "connected",
      "note": ""
    }
  ]
}