Listing Statuses
Listing statuses are used to track the current state of a shipment from the perspective of the user viewing the listing. For example, after a Shipper leaves feedback on a booked shipment, the listing status will change to "Completed." However, from the Service Provider's view, the status will remain as 'Booked' until they leave feedback. When managing listings via the API, this means it is possible that the value passed in a filter may in certain cases be different than the display status.
| Value | Description | Available Actions |
|---|---|---|
| Active | The listing is available and not booked. The listing will remain active until it expires. If the listing has active bids at the end of their auction window, the Shipper has 24 hours to accept a bid before the bids expire. Through Published Rates, if the listing has a booking request on it (for a Service Provider to accept), the listing becomes “booking request pending” and is temporarily unavailable for booking. If the Service Provider does not accept the booking request within 24 hours, the listing goes back to this state (Active). | - Shipper: Edit the listing, add items to the listing, delete the listing, relist the listing |
| Booked | The listing is active and has an accepted bid. Booked listings allow a transit status for the matched Shipper and Service Provider (booked delivery). |
|
| Closed | The Shipper's listing auction has ended and the listing either did not receive any quotes or all of the quotes have expired. |
|
| Completed (Delivered) | The user who marked the listing as “delivered” will see it in this status (e.g., the Shipper). In this case, it will still display as "booked" for the Service Provider who did not mark the listing “delivered” will still see the listing in the “booked” state. Typically, this status will result after the Shipper marks the listing as delivered and releases the payment code to the Service Provider. | - Shipper: Print the Bill of Lading, leave service provider feedback, or mark as Not Delivered. |
| Archived | The booked listing is unavailable because it got delivered (both parties marked it delivered) and both the Service Provider and the Shipper left feedback. | |
| Deleted | The lister has removed the listing. Only the creator of a listing can delete it, and it can only be deleted when it is in the Active status. | |
| onHold | The listing is not publicly viewable or available to book. The listing remains “onHold” until a user takes the listing out of this status or the listing expires or the quote that put the listing in an “onHold” state expires. | |
| Saved | This status is only available via the API. If the listing was created via the API and is either in the “Cars and Light Trucks” (CLT) subcategory or the “Household Goods” category, the listing goes from having no state to this “saved” state. After 30 minutes, the listing becomes “Active”. | The lister is able to add additional information during this time before the status goes Active. |