/delivery/status-updates

Delivery status event updates

Sent whenever a delivery's status changes. Match the event to your order using taskId.

{
    "taskStatusId": 1,
    "createdAt": "2023-07-20T09:56:43.331140Z",
    "taskId": 1,
    "value": "OUT_FOR_DELIVERY"
}

Status values

value is one of:

ValueMeaning
NOT_STARTEDBooked and accepted; nothing has happened physically yet
OUT_FOR_COLLECTIONA courier is on the way to collect
COLLECTEDThe parcel is with the courier
OUT_FOR_DELIVERYOn the way to the delivery address
COMPLETEDDelivered successfully
FAILEDCould not be delivered
CANCELLEDCancelled before completion

COMPLETED, FAILED and CANCELLED are final.

A status can repeat — for example on a second delivery attempt — and events aren't guaranteed to arrive in order. Ignore any event older than the state you already hold.

See How a delivery works for the full lifecycle.