List endpoints
Every webhook endpoint on your account, newest first, with its health. failure_count counts consecutive failures and resets to zero on a success. last_delivery_at moves only on a success, so a null there on a busy endpoint is what a failing signature check looks like from our side. The signing secret is never returned.
Not counted: webhook management is an account path and spends no call quota. The event deliveries we send are free. See what counts as a successful request.
Response schema
101 fields
Generated from the OpenAPI spec. Nested exactly as the JSON is. Open a branch to read its fields; hover a name for the full dot-path.
Whether the request succeeded.
data
The payload. Everything an endpoint returns sits under this key.
The list of results.
items[]
Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.
Where we POST the events.
The stored subscription, after unrecognised names were filtered out. One of: api_change_announced, container_arrived, container_available, container_delivered, container_misrouted, customs_hold, demurrage_started, demurrage_warning, eta_changed, schedule_disruption, shipment_updated, vessel_departed, vessel_rollover.
The carrier own phrasing for the event, falling back to our word for the code.
False while the endpoint is paused. A paused endpoint keeps its secret and its history.
Consecutive delivery failures.
When we last attempted a delivery. Null before the first one.
When the record was created (ISO 8601).
When the endpoint was disabled.
Manual disable or automatic disable after repeated delivery failures.
Last receiver error at automatic disable; null for manual disable or an active endpoint.
Existing record id. Only on status 401, 403, 429, 500 and 504.
When tracking stopped. Only on status 401, 403, 429, 500 and 504.
Null when your account archived it, otherwise the reason our archiver closed it. Only on status 401, 403, 429, 500 and 504.
resume
Only on status 401, 403, 429, 500 and 504.
body
The reference to add again.
The response contract this build answers, as a date (YYYY-MM-DD).
error
Only on status 401, 403, 429, 500 and 504.
Machine readable error code.
Human readable explanation.
How serious the error is.
True.
The reference.
Seconds to wait.
Offending fields.
CONTAINER_QUOTA_EXCEEDED only.
Tokens this request needs.
Tokens the wallet holds.
Where to top up.
Plans on offer.
packages[]
Plan key.
Tokens per month.
Monthly price in USD.
CARRIER_NOT_IDENTIFIED only.
CARRIER_NOT_IDENTIFIED, timed out only.
The member cycle limit.
Tokens the member has used this cycle.
Tokens left for the member.
Seconds until the next refresh is allowed.
progress
One of: SEALINE_HASNT_PROVIDE_INFO, NO_EVENTS, WRONG_NUMBER, REFERENCE_REQUIRED, LINE_NOT_SUPPORTED, PENDING, UNRESOLVED.
previous_trip
The trip before yours for this box, when the line still reports it.
The line that answered, as its SCAC.
last_event
events[]
A note for leasing-company accounts when no line holds the box yet.
One of: in_progress, not_supported, connected, reference_required.
carrier_notice
Latest reference-specific reply from the named carrier. Only on status 401, 403, 429, 500 and 504.
One of: other_carrier, temporarily_unavailable, not_found, invalid_reference, SHIPMENT_CANCELLED, no_longer_available.
Present when the line named was not used. Only on status 401, 403, 429, 500 and 504.
Known line that cannot be asked. Only on status 401, 403, 429, 500 and 504.
upgrade
CONTAINER_QUOTA_EXCEEDED only. Only on status 401, 403, 429, 500 and 504.
Next plan.
Monthly price.
Annual price.
Why the line named was not used. Only on status 401, 403, 429, 500 and 504.
curl 'https://api.navo24.com/v1/tracking/webhooks' \
-H "Authorization: Bearer tmcp_YOUR_API_KEY"const res = await fetch("https://api.navo24.com/v1/tracking/webhooks", {
headers: {
"Authorization": "Bearer tmcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.navo24.com/v1/tracking/webhooks",
headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json(){
"api_version": "2026-08-04",
"ok": true,
"data": {
"items": [
{
"id": "3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10",
"url": "https://example.com/navo-docs-capture",
"event_types": [],
"description": "Docs capture, staging only",
"active": true,
"failure_count": 0,
"last_delivery_at": null,
"created_at": "2026-08-19T15:07:46.481165+00:00"
}
]
}
}