A common use case of ShipBob’s API includes filtering orders, shipments, returns, or WROs by status. Here you will find the valid statuses by resource.

​
Shipment Statuses

Shipment statuses reflect what is happening in the physical world with the package. There is an additional “status detail” section with more detailed information that is also available in our ShipBob Merchant Application.
  • Exception: the shipment cannot be fulfilled due to an out of stock or inactive product.
  • On Hold: the shipment is not ready for fulfillment, even if there is stock available. Common reasons are: merchant manually placed on hold, missing tarriff codes on international orders, or bad credit card information.
  • Processing: the shipment is in the process of fulfillment.
  • Completed: the shipment has been fulfilled, i.e. it has left ShipBob. This does not mean it has been delivered by the carrier.
  • Cancelled: the shipment has been cancelled and will not be fulfilled.
The most important statuses and status details are listed here:
Shipment StatusStatus Detail NameStatus Detail DescriptionStatus Detail ID
ProcessingPickedPicking Completed100
ProcessingPackedPacking Completed101
ProcessingLabeledLabel Generated102
CompletedProcessingWaiting For Carrier Pickup200
CompletedInTransitShipment In Transit201
CompletedOutForDeliveryShipment Out For Delivery202
CompletedDeliveredShipment Delivered203
CompletedDeliveryExceptionOrderTracking contains CatchAll date204
ExceptionBundleShipment Contains Bundle Item300
ExceptionMergedItemShipment Contains Merge Child301
ExceptionInactiveSkuShipment Contains an inactive sku302
ExceptionOutOfStockNo Stock On Hand For Sku303
ExceptionUnknownSkuNo Sku History (if there are no reasons)304
ExceptionInternalTransferInProgressStock Being Transferred Between FCs305
ExceptionBinTransferInProgressStock Being Transferred Between Bins306
ExceptionInventoryInNonPickableLocationStock In Non-pickable Location307
ExceptionInventoryPartiallyCommittedShipment is partially allocated308
On HoldPaymentDeclinedPayment Failure400
On HoldInvalidAddressInvalid Address401
On HoldReserveDateNotMetWait For Pick Date402
On HoldMissingTarriffInformationMissing Customs Info404
On HoldManualManual405
On HoldInternationalHazmatHazmat Inventory cannot be shipped internationally406
On HoldPackagePreferenceNotSetNo Package Preference Set For Inventory407
On HoldAutoProcessingPauseAutomatic Processing Pause408

​
Order Statuses

Orders can have 1 or many shipments (if the contents will not fit in 1 box, for example). Order statuses are imputed from the statuses of the underlying shipments.
Shipment 1 StatusShipment n StatusOrder Status
ProcessingProcessing
ExceptionException
On HoldOn Hold
CompletedCompleted
CancelledCancelled
ProcessingProcessingProcessing
ProcessingExceptionProcessing
ProcessingOn HoldProcessing
ProcessingCancelledProcessing
ProcessingCompletedPartially Fulfilled
ExceptionExceptionException
ExceptionOn HoldException
ExceptionCompletedPartially Fulfilled
ExceptionCancelledException
On HoldOn HoldException
On HoldCompletedPartially Fulfilled
On HoldCancelledException
CompletedCompletedFulfilled
CompletedCancelledPartially Fulfilled
CancelledCancelledCancelled

​
Warehouse Receiving Order Statuses

StatusDescription
AwaitingWRO has been created and awaiting arrival to the warehouse
Processing
Arrived
PartiallyArrived
PartiallyArrivedAtHub
ArrivedAtHub
ProcessingAtHub
InternalTransfer
CompletedWRO has been completed
CancelledWRO has been cancelled

​
Return Statuses

StatusDescription
AwaitingArrivalReturn has been created and awaiting arrival to the warehouse
ArrivedReturn has arrived at the warehouse
ProcessingReturn is processing at the warehouse
CompletedReturn has been processed and is completed
CancelledReturn has been cancelled