Central Dispatch’s Listings API allows customers to create, retrieve, update, and manage vehicle shipment listings on the marketplace.
🔑 Scope: marketplace
🚨🚨🚨 If you are a new integator, please use Listings API V2. 🚨🚨🚨
Production server
Provide your bearer token in the Authorization header when making requests to protected resources.
Example: Authorization: Bearer 123
Create a listing.
Location header that contains the fully qualified URL of the newly created resource. The final segment of the URL will be the ID of the resource.The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.
Example:application/vnd.coxauto.v1+json
Listing
Details of a listing.
Details of a location.
Details of a location.
The total travel distance.
Example:267
Additional information.
<= 60 characters
Example:The vehicle is in the back of the lot behind the big tree.
The ID of the shipper order.
<= 50 characters
Example:123-abc 900
The vehicle trailer type.
Allowed values:OPENENCLOSEDDRIVEWAY
Example:OPEN
Indicates if listing includes a vehicle that is inoperable.
Default:false
Example:false
Details of a vehicle.
The available date of the listing, in UTC/ISO 8601 format.
Example:2025-11-05T00:00:00.000Z
The desired delivery date of the listing, in UTC/ISO 8601 format.
Example:2025-07-15T00:00:00.000Z
Details of the price.
A user supplied ID used for reference.
Example:3fde6068-5fa2-4ae4-af16-06d65fc87dc9
An identifier managed by the user. Shippers can use this field to map Central Dispatch dispatch ID to a record (e.g. order, shipment, dispatch) in their local TMS.
<= 50 characters
Example:RND10 CHEV
Created. Successful request.
Get the listing for the provided listing ID.
Location header that contains the fully qualified URL of the newly created resource. The final segment of the URL will be the ID of the resource.ETag header, which should be used for the If-Match header in subsequent updates.Example:42220470
The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Accept header should be set to application/vnd.coxauto.v1+json.
Example:application/vnd.coxauto.v1+json
OK. Successful request.
Details of a listing.
The ID of the listing. 🔒 Read-only, will be set when the listing is created.
Example:42220470
The ID of the Central Dispatch customer who is the shipper. 🔒 Read-only, will be set when the listing is created.
Example:afd2fb59-b89d-4572-8f9a-e57f82a61c68
The fully qualified URL of the listing. 🔒 Read-only.
Example:https://marketplace-api.centraldispatch.com/listings/id/42220470
The status of the listing, not editable.
Allowed values:LISTEDEXPIREDDELETEDARCHIVEDPENDING
Example:LISTED
Details of a location.
Details of a location.
The total travel distance.
Example:267
Additional information.
<= 60 characters
Example:The vehicle is in the back of the lot behind the big tree.
The ID of the shipper order.
<= 50 characters
Example:123-abc 900
The vehicle trailer type.
Allowed values:OPENENCLOSEDDRIVEWAY
Example:OPEN
Indicates if listing includes a vehicle that is inoperable.
Default:false
Example:false
The number of vehicles in the listing. 🔒 Read-only.
Example:2
Details of a vehicle.
The available date of the listing, in UTC/ISO 8601 format.
Example:2025-11-05T00:00:00.000Z
The date and time the listing was created, in UTC/ISO 8601 format. 🔒 Read-only, will be set when the listing is created.
Example:2024-08-01T00:00:00Z
The date and time the listing was deleted, in UTC/ISO 8601 format. 🔒 Read-only, will be set when the listing is deleted.
Example:2024-09-10T00:00:00Z
The date and time the listing was archived, in UTC/ISO 8601 format. 🔒 Read-only, will be set when the listing is archived.
Example:2024-10-15T00:00:00Z
The expiration date of the listing, in UTC/ISO 8601 format. 🔒 Read-only, will be set when the listing is created or updated.
Example:2025-08-15T00:00:00.000Z
The desired delivery date of the listing, in UTC/ISO 8601 format.
Example:2025-07-15T00:00:00.000Z
Details of the price.
A user supplied ID used for reference.
Example:3fde6068-5fa2-4ae4-af16-06d65fc87dc9
An identifier managed by the user. Shippers can use this field to map Central Dispatch dispatch ID to a record (e.g. order, shipment, dispatch) in their local TMS.
<= 50 characters
Example:RND10 CHEV