API referenceReference
Shipment statuses
What each shipment status means and the order shipments usually move through them.
Shipments can be fulfilled by various partner carriers, where each partner carrier may support a different level of granularity in their shipment statuses. For example, shipments fulfilled by Mothership Carrier provide the most detailed tracking through the Mothership app, while some other partner carriers may only provide a limited set of updates.
Stop 1 of 7
Unallocated
Shipment has been purchased, but has not been assigned to a partner carrier. All shipments begin in this status.
Read it from data.status on Retrieve a shipment, or subscribe to the webhook.
Every shipment starts in this status when it is booked, which sends a shipment.purchased event.
| Status | Behavior |
|---|---|
| Unallocated | Shipment has been purchased, but has not been assigned to a partner carrier. All shipments begin in this status. |
| FindingDriver | Shipment has been dispatched and is being allocated to the most optimal carrier. Deprecated. |
| DriverAllocated | Shipment has been assigned to a partner carrier. |
| EnrouteToPickup | Carrier is en route to the pickup location. |
| ArrivedAtPickup | Carrier has arrived at the pickup location and is in the process of picking up the freight. |
| EnrouteToDelivery | Carrier has picked up the freight and is en route to the delivery location. |
| ArrivedAtDelivery | Carrier has arrived at the delivery location and is in the process of delivering the freight. |
| Completed | Shipment has been completed. |
| Cancelled | Shipment has been cancelled. |
Shipments usually (but not always) proceed through the statuses listed above in order. However, in certain circumstances a shipment may jump ahead multiple statuses or revert to a previous status (for instance, if the shipment is assigned to one carrier and then reassigned to a second carrier for optimization purposes).
Subscribe to the shipment.status.updated webhook to hear about each change, or read status from Retrieve a shipment.