Delivery status reference
The statuses that may appear in the status field of a delivery or webhook event. EXPRESS and LOGISTIC have different lifecycles — pick a tab below to see the statuses applicable to that category.
- EXPRESS
- LOGISTIC
QUEUEING
Scheduled delivery is waiting for its pickup window. Will transition to ALLOCATING when the window opens.
ALLOCATING
Dash is finding the nearest available driver.
courier is null at this stage.PENDING_PICKUP
A driver has accepted the job but hasn't moved yet.
trackingURL becomes available from this status onward. Driver may still be re-assigned — re-assignment fires a new webhook with updated courier data.PICKING_UP
Driver is on their way to the pickup location.
PENDING_DELIVERY
Package has been picked up and is in an intermediate state before reaching IN_DELIVERY.
pickupAt and PICKUP_PROOF media are now present.IN_DELIVERY
Driver is en route to the recipient with the package in hand.
COMPLETED
Driver captured
DELIVERY_PROOF at the destination. Terminal state.CANCELLED
Cancelled by the provider before the package was picked up — while status was ALLOCATING, PENDING_PICKUP, or PICKING_UP. Terminal state.
FAILED
Driver could not complete the drop (recipient unavailable, COD refused, SLA exceeded, etc.).
failedReason is populated. Terminal state.LOGISTIC has no QUEUEING (no scheduled-pickup queue), no ALLOCATING / PENDING_PICKUP (no driver-allocation phase), and no PICKING_UP (the warehouse hand-off replaces it).
PREPARING
Delivery has been accepted by the system and is awaiting warehouse verification. Confirmation that the record exists.
VERIFIED
Package verified by ops at the warehouse and ready to be staged for the delivery leg.
NOT_VERIFIED
Manifest received by the ops team but the physical package wasn't received. Can transition back to
VERIFIED once the package arrives.PENDING_DELIVERY
Verified package staged and assigned for the delivery leg.
IN_DELIVERY
Driver is en route to the recipient. (No
trackingURL on LOGISTIC.)COMPLETED
Driver captured
DELIVERY_PROOF at the destination. Terminal state.FAILED
Drop could not complete. Dash Ops may recover the delivery back to
PENDING_DELIVERY for a retry. Otherwise terminal.