Endpoint detail and deliveries
One endpoint plus its 20 most recent delivery attempts. This is where you look when an event did not arrive: status is pending, delivered or dead, and last_error carries either the HTTP status code or the transport error we saw. Answers 404 NOT_FOUND for an unknown id or one on another account.
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.
Path parameters
Endpoint id from registration.
Response schema
108 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
A registered webhook endpoint.
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.
Up to 20 attempts, newest first.
recent_deliveries[]
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.
The event delivered.
Outcome of that one delivery: pending while it is queued or waiting on a retry, delivered once your endpoint accepted it, dead once the retry ladder is exhausted.
How many times this one delivery was attempted, retries included.
HTTP status your endpoint returned on the last attempt.
What went wrong on the last attempt. Null on a delivered event.
When the record was created (ISO 8601).
When your endpoint accepted the event. Null while it is still failing or queued.
When tracking stopped. Only on status 401, 403, 404, 429, 500 and 504.
Null when your account archived it, otherwise the reason our archiver closed it. Only on status 401, 403, 404, 429, 500 and 504.
resume
Only on status 401, 403, 404, 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, 404, 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, 404, 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, 404, 429, 500 and 504.
Known line that cannot be asked. Only on status 401, 403, 404, 429, 500 and 504.
upgrade
CONTAINER_QUOTA_EXCEEDED only. Only on status 401, 403, 404, 429, 500 and 504.
Next plan.
Monthly price.
Annual price.
Why the line named was not used. Only on status 401, 403, 404, 429, 500 and 504.
curl 'https://api.navo24.com/v1/tracking/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10' \
-H "Authorization: Bearer tmcp_YOUR_API_KEY"const res = await fetch("https://api.navo24.com/v1/tracking/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10", {
headers: {
"Authorization": "Bearer tmcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.navo24.com/v1/tracking/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10",
headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json(){
"api_version": "2026-08-04",
"ok": true,
"data": {
"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",
"recent_deliveries": [
{
"id": "6b2f4c81-9d35-4e70-a18c-5f7e2a9b4d63",
"event_type": "ping",
"status": "pending",
"attempt_count": 0,
"last_status_code": null,
"last_error": null,
"created_at": "2026-08-19T15:07:47.189259+00:00",
"delivered_at": null
}
]
}
}