Skip to main content
Metrics type: Supporting MetricsCategory: Operational Health

At a glance

Share of calls to the Sendle API that returned an error (HTTP 4xx or 5xx) over the trailing 24 hours. This is the connector-health pulse behind despatch: when the error rate climbs, label creation, order booking and tracking polls start failing, and parcels stop moving. The alert fires above 2 percent, which for a busy despatch desk is the difference between a clean run and a queue of stuck orders.

What it tracks

The card reads the response status of every request the connector makes to the Sendle API (POST /api/orders for booking and labels, GET /api/orders/{id}/tracking for scan polls, GET /api/me for auth checks) and expresses errors as a percentage of total calls in the window. The time_window is 24H, so it is a rolling-day view that catches incidents fast rather than smoothing them away. The alert trips at >2%. A 5xx spike points to a Sendle-side outage (cross-check Sendle Tracking API Unavailable / 5xx); a 401 / 403 cluster points to an invalidated or rotated key (cross-check Days to Token Expiry); a 422 cluster usually means malformed booking payloads (bad postcodes, missing dimensions) rather than a Sendle fault. The most visible downstream symptom is a drop on Label Generation Success.

Reconciling against the source

Sendle does not publish a per-merchant API error log in the dashboard, so reconcile against the Sendle status page for platform-wide incidents and against your own connector logs in Vortex IQ for the request-level detail. A rising error rate with a green status page is almost always an auth or payload issue at your end, not a Sendle outage.

Tracked live in Vortex IQ Nerve Centre

API Error Rate is one of hundreds of KPI pulses Vortex IQ tracks across Sendle and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English. Start for free or book a demo to see this metric running on your own data.