Shipment lookup
One box for a Navo trip ID, a container number (answered as /container) or a route like "Chongqing to Duisburg" (answered as /route). coords trimmed in the example.
Query parameters
Trip ID, container number or "from to to".
Response schema
44 fields
Derived from the example response, nested as the JSON is.
data
The payload. Everything an endpoint returns sits under this key.
from
Human-readable name.
Country name.
Latitude.
Longitude.
UN/LOCODE of the place.
carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.
to
Human-readable name.
Country name.
Latitude.
Longitude.
UN/LOCODE of the place.
carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.
sections[]
from
Latitude.
Longitude.
carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.
to
Latitude.
Longitude.
carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.
True when any card in the total used an estimated capacity.
Errors
A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.
No key in Authorization or x-api-key.
The key is unknown or revoked.
More than 40 requests in one minute from one client.
curl 'https://api.navo24.com/v1/rail/shipment?q=Chongqing%20to%20Duisburg' \
-H "Authorization: Bearer tmcp_YOUR_API_KEY"const res = await fetch("https://api.navo24.com/v1/rail/shipment?q=Chongqing%20to%20Duisburg", {
headers: {
"Authorization": "Bearer tmcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.navo24.com/v1/rail/shipment?q=Chongqing%20to%20Duisburg",
headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json(){
"data": {
"from": {
"name": "Chongqing",
"cc": "CN",
"country": "China",
"lat": 29.56026,
"lng": 106.55771,
"locode": "CNCQI",
"kind": "city",
"tz": "Asia/Shanghai",
"q": "29.56026,106.55771"
},
"to": {
"name": "Duisburg",
"cc": "DE",
"country": "Germany",
"lat": 51.43247,
"lng": 6.76516,
"locode": "DEDUI",
"kind": "city",
"tz": "Europe/Berlin",
"q": "51.43247,6.76516"
},
"km": 10232.0,
"hours": 341.1,
"days": 14.21,
"moving_hours": 341.1,
"handling_hours": 0,
"speed_kmh": 30.0,
"sections": [
{
"mode": "RAIL",
"km": 10232.0,
"hours": 341.1,
"driving_hours": null,
"from": {
"lat": 29.56371,
"lng": 106.55993,
"kind": "rail_terminal"
},
"to": {
"lat": 51.42889,
"lng": 6.77389,
"kind": "rail_terminal"
},
"coords": [
[
106.55993,
29.56371
],
[
106.53,
29.55722
]
]
}
],
"transfers": [],
"estimated": false,
"routing_mode": "safe"
}
}