Search
K
Listings API V2

Listing API

2.0.0OAS 3.0

Central Dispatch’s Listing API allows customers to create, retrieve, update, and manage vehicle shipment listings on the marketplace.
🔑 Scope: marketplace

API Base URL
  • Server 1:https://marketplace-api.centraldispatch.com

    Production server

Security
Bearer (http)

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123

Additional Information
Contact (datasyndicationsupport@centraldispatch.com)

Create Listing

Create a listing.

👥 Customer Type

  • Shipper

📝 Important Notes

  • The listing must have exactly 2 stops (pickup and delivery).
  • At least one vehicle must be specified, a maximum of 12 vehicles allowed per listing, no duplicate vehicle IDs allowed.
  • The response will contain a 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.
post
https://marketplace-api.centraldispatch.com/listings

Headers

Content-Typestringrequired

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 2.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v2+json.

Example:application/vnd.coxauto.v2+json

Body

application/json

ListingRequest

ListingRequest

Details of a listing.

shipperOrderIdstring | null

The ID of the shipper order.

<= 50 characters

Example:123-abc 900

externalIdstring | null

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

trailerTypestring

The trailer type.

Allowed values:DRIVEAWAYENCLOSEDOPEN

Default:OPEN

Example:OPEN

hasInOpVehicleboolean

Indicates whether the vehicle is inoperable.

Default:true

Example:false

loadSpecificTermsstring | null

These are provisions added to a contract that specify extra obligations, rights, or conditions beyond the standard terms.
Real Life Example: Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.
Rules: This information will be visible only to the assigned carrier after the load is dispatched, and it will no longer be editable at that point.

<= 500 characters

Example:Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.

requiresInspectionboolean | null

Indicates the shipper requests for the carrier to use the Central Dispatch Mobile App to perform vehicle inspection at pickup and delivery. If true, the carrier will be asked to acknowledge the request before accepting the load.

Default:false

Example:true

requiresDriverVerificationAtPickupboolean | null

Indicates if the driver verification process is required. A driver must be assigned to the load before delivery. Information will be emailed to the contact physically present at the pickup location for use in verifying the driver’s identification. The Central Dispatch Mobile App must be used to perform the pickup and delivery inspection. (Only currently applicable to select private Marketplaces).

Default:false

Example:true

availableDatestring(date-time)

The available date of the listing, in UTC/ISO 8601 format. Must not be before today or later than 30 days from today.

Example:2025-02-20T00:00:00Z

expirationDatestring | null(date-time)

The expiration date of the listing, in UTC/ISO 8601 format. Must not be before today or later than 30 days from today. Will default to after creation date if not supplied.

Example:2025-03-10T00:00:00Z

desiredDeliveryDatestring | null(date-time)

The desired delivery date of the listing, in UTC/ISO 8601 format. Must be equal or greater than availableDate and not before today or later than 30 days from today (optional).

Example:2025-03-04T00:00:00Z

partnerReferenceIdstring | null

A user supplied ID used for reference.

<= 50 characters

Example:969175d4-a3f8-4e43-b64f-a95d77475aa0

priceobject

Details of the price.

Show Child Parameters
slaobject

Details of the service level agreement (SLA) for a listing. Only required for listings in marketplaces allowing digital offers. Currently only applicable to private marketplaces.

Show Child Parameters
stopsarray[object]

Details of a stop.

Show Child Parameters
vehiclesarray[object]

Details of a vehicle.

Show Child Parameters
marketplacesarray[object]

Details of a marketplace.

Show Child Parameters
tagsarray | null[object]

Details of a tag.

Show Child Parameters
transportationReleaseNotesstring | null

Displayed in Central Dispatch website/app as “Transport Special Instructions”, these are specific guidelines or details for the safe and efficient pick up, delivery, or transportation of a load. This may contain sensitive data and is not available prior to acceptance of terms by a carrier.
Rules: This information is visible only to the assigned carrier after the load is dispatched and remains editable at any time.

Example:You will need special clearance to get in the lot. Call Jean at 303-999-1212.

Response

Created. Successful request.

post/listings

Body

{ "shipperOrderId": "123-abc 900", "externalId": "RND10 CHEV", "trailerType": "OPEN", "hasInOpVehicle": false, "loadSpecificTerms": "Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.", "availableDate": "2025-02-20T00:00:00Z", "expirationDate": "2025-03-10T00:00:00Z", "desiredDeliveryDate": "2025-03-04T00:00:00Z", "partnerReferenceId": "ORD-2023-0001", "price": { "total": 500, "cod": { "amount": 200, "paymentMethod": "CASH_CERTIFIED_FUNDS", "paymentLocation": "PICKUP" }, "balance": { "amount": 300, "paymentTime": "IMMEDIATELY", "balancePaymentTermsBeginOn": "PICKUP", "balancePaymentMethod": "CASH" } }, "sla": { "duration": "P2D", "timeZoneOffset": "-7:00", "rolloverTime": "19:00:00", "includeCurrentDayAfterRollOver": true }, "stops": [ { "stopNumber": 1, "locationName": "ABC Cars lot", "address": "345 W Elm St.", "city": "Anaheim", "state": "CA", "postalCode": "92802", "country": "US", "phone": "949-555-1323", "contactName": "Mickey Smith", "contactPhone": "949-555-2434", "geoCode": { "longitude": -117.91836265987132, "latitude": 33.81228788622535 }, "locationType": "Dealership" }, { "stopNumber": 2, "locationName": "XYZ Inc.", "address": "255 Sands Ave.", "city": "Las Vegas", "state": "NV", "postalCode": "89169", "country": "US", "phone": "702-555-0101", "contactName": "Dean Vega", "contactPhone": "702-555-1212", "geoCode": { "longitude": -115.16195281104913, "latitude": 36.121343020081525 }, "locationType": "Dealership" } ], "vehicles": [ { "pickupStopNumber": 1, "dropoffStopNumber": 2, "externalVehicleId": "EXT123456", "vin": "KL8CH6SA6NC001234", "year": 2022, "make": "Chevrolet", "model": "Spark", "trim": "LS", "vehicleType": "CAR", "color": "Red", "licensePlate": "B314PIE", "lotNumber": "LOT789", "isInoperable": false, "tariff": 1030.5, "additionalInfo": "The vehicle is in the back of the lot behind the big tree.", "shippingSpecs": { "height": 58, "width": 62, "length": 143, "weight": 2246 } } ], "marketplaces": [ { "marketplaceId": 10000, "digitalOffersEnabled": true, "searchable": true, "offersAutoAcceptEnabled": true, "autoDispatchOnOfferAccepted": true, "predispatchNotes": "In order to pick up the keys you will have to walk through a lot with a big dog that protects it, he's chained but will bark at you.", "customersExcludedFromOffers": [ "157a16f0-503d-4256-ba60-a4876e8eb9bb" ] } ], "tags": [ { "name": "The number one", "value": "1d1d1d1d-e89b-12d3-a456-426614174000" } ], "transportationReleaseNotes": "You will need special clearance to get in the lot. Call Jean at 303-999-1212." }
 

Get Listings

Get a collection of listings based on the specified search criteria.

👥 Customer Type

  • Shipper

🔍 Allowed Search Criteria

partnerReferenceId: A user supplied ID used for reference.

📝 Important Notes

Be sure to URL encode any parameters that contain spaces or special characters.

get
https://marketplace-api.centraldispatch.com/listings

Query Parameters

partnerReferenceIdstring | null

A user supplied ID used for reference.

Default:null

Example:dad00000-e89b-12d3-a456-426614174000

startinteger(int32)

Default:1

Example:1

limitinteger(int32)

Default:25

>= 0<= 500

Example:10

Headers

Acceptstringrequired

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 2.x.x of an API, the Accept header should be set to application/vnd.coxauto.v2+json.

Example:application/vnd.coxauto.v2+json

Response

application/json

OK. Successful request.

ListingCollection

A collection of listings.

hrefstring

The URL used to query the current collection of the resource.

Example:https://marketplace-api.centraldispatch.com/listings?limit(5,1)

countinteger(int32)

The total count of resources in the collection.

Example:23

itemsarray[object]

Details of a listing.

Show Child Parameters
get/listings
 
application/json

Get Listing

Get the listing for the provided listing ID.

👥 Customer Type

  • Shipper

📝 Important Notes

  • The ID of the resource is returned in resource’s create endpoint. The response will contain a 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.
get
https://marketplace-api.centraldispatch.com/listings/id/{id}

Path Parameters

idinteger(int64)required

Example:42220470

Headers

Acceptstringrequired

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 2.x.x of an API, the Accept header should be set to application/vnd.coxauto.v2+json.

Example:application/vnd.coxauto.v2+json

Response

application/json

OK. Successful request.

ListingResponse

Details of a listing.

listingIdinteger(int64)

The ID of the listing.

Example:42220470

shipperIdstring(uuid)

The ID of the Central Dispatch customer who is the shipper.

Example:afd2fb59-b89d-4572-8f9a-e57f82a61c68

loadSpecificTermsstring | null

These are provisions added to a contract that specify extra obligations, rights, or conditions beyond the standard terms.
Real Life Example: Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.
Rules: This information will be visible only to the assigned carrier after the load is dispatched, and it will no longer be editable at that point.

Example:Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.

archivedDatestring | null(date-time)

The date and time the listing was archived, in UTC/ISO 8601 format.

Example:2024-08-01T00:00:00Z

availableDatestring(date-time)

The available date of the listing, in UTC/ISO 8601 format.

Example:2025-11-05T00:00:00.000Z

createdOnstring(date-time)

The date and time the listing was created, in UTC/ISO 8601 format.

Example:2024-10-15T00:00:00Z

deletedDatestring | null(date-time)

The date and time the listing was deleted, in UTC/ISO 8601 format.

Example:2024-09-10T00:00:00Z

desiredDeliveryDatestring | null(date-time)

The desired delivery date of the listing, in UTC/ISO 8601 format.

Example:2025-03-04T00:00:00Z

expirationDatestring(date-time)

The expiration date of the listing, in UTC/ISO 8601 format.

Example:2025-08-15T00:00:00.000Z

externalIdstring | null

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.

Example:RND10 CHEV

hasInOpVehicleboolean

Indicates whether the vehicle is inoperable.

Example:false

hrefstring

The fully qualified URL of the dispatch.

Example:https://marketplace-api.centraldispatch.com/listings/id/42220470

listingStatusstring

The status of the listing.

Allowed values:ACTIVEARCHIVEDDELETED

Example:ACTIVE

partnerIdstring | null

The Central Dispatch ID of the partner who created or last updated the transaction on behalf of the customer. Will be null if the customer made the API call directly.

Example:b6e8c9e4-989a-4b37-8dd7-99fd34882bd0

clientIdstring | null

The Central Dispatch ID of the user who created or last updated the resource.

Example:6e93ff07-6ea6-4239-b502-7bf4f68d2600

requiresInspectionboolean

Indicates the shipper requests for the carrier to use the Central Dispatch Mobile App to perform vehicle inspection at pickup and delivery. If true, the carrier will be asked to acknowledge the request before accepting the load.

Example:true

requiresDriverVerificationAtPickupboolean

Indicates if the driver verification process is required. A driver must be assigned to the load before delivery. Information will be emailed to the contact physically present at the pickup location for use in verifying the driver’s identification. The Central Dispatch Mobile App must be used to perform the pickup and delivery inspection. (Only currently applicable to select private Marketplaces).

Example:true

marketplacesarray[object]

Details of the marketplace.

Show Child Parameters
partnerReferenceIdstring | null

A user supplied ID used for reference.

Example:25-KL8CH6

priceobject

Details of the price.

Show Child Parameters
shipperOrderIdstring | null

The ID of the shipper order.

Example:123-abc 900

slaobject

Details of the service level agreement (SLA) for a listing.

Show Child Parameters
sourcestring

The source of the listing.

Allowed values:APIUI

Example:API

stopsarray[object]

Details of a stop.

Show Child Parameters
tagsarray | null[object]

Details of a listing tag.

Show Child Parameters
totalDistanceInMilesinteger(int32)

The total travel distance in miles.

Example:267

trailerTypestring

The trailer type.

Allowed values:DRIVEAWAYENCLOSEDOPEN

Default:OPEN

Example:OPEN

vehiclesarray[object]

Details of a vehicle.

Show Child Parameters
transportationReleaseNotesstring | null

Displayed in Central Dispatch website/app as “Transport Special Instructions”, these are specific guidelines or details for the safe and efficient pick up, delivery, or transportation of a load. This may contain sensitive data and is not available prior to acceptance of terms by a carrier.
Rules: This information is visible only to the assigned carrier after the load is dispatched and remains editable at any time.

Example:You will need special clearance to get in the lot. Call Jean at 303-999-1212.

get/listings/id/{id}
 
application/json

Update Listing

Update a listing.

👥 Customer Type

  • Shipper

📝 Important Notes

  • This operation replaces the entire listing.
  • All Create Listing validation rules apply.
  • The If-Match header is required and its value can be found in the ETag response header of the resource’s GET by ID endpoint.
put
https://marketplace-api.centraldispatch.com/listings/id/{id}

Path Parameters

idinteger(int64)required

Example:42220470

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

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 2.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v2+json.

Example:application/vnd.coxauto.v2+json

Body

application/json

ListingRequest

ListingRequest

Details of a listing.

shipperOrderIdstring | null

The ID of the shipper order.

<= 50 characters

Example:123-abc 900

externalIdstring | null

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

trailerTypestring

The trailer type.

Allowed values:DRIVEAWAYENCLOSEDOPEN

Default:OPEN

Example:OPEN

hasInOpVehicleboolean

Indicates whether the vehicle is inoperable.

Default:true

Example:false

loadSpecificTermsstring | null

These are provisions added to a contract that specify extra obligations, rights, or conditions beyond the standard terms.
Real Life Example: Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.
Rules: This information will be visible only to the assigned carrier after the load is dispatched, and it will no longer be editable at that point.

<= 500 characters

Example:Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.

requiresInspectionboolean | null

Indicates the shipper requests for the carrier to use the Central Dispatch Mobile App to perform vehicle inspection at pickup and delivery. If true, the carrier will be asked to acknowledge the request before accepting the load.

Default:false

Example:true

requiresDriverVerificationAtPickupboolean | null

Indicates if the driver verification process is required. A driver must be assigned to the load before delivery. Information will be emailed to the contact physically present at the pickup location for use in verifying the driver’s identification. The Central Dispatch Mobile App must be used to perform the pickup and delivery inspection. (Only currently applicable to select private Marketplaces).

Default:false

Example:true

availableDatestring(date-time)

The available date of the listing, in UTC/ISO 8601 format. Must not be before today or later than 30 days from today.

Example:2025-02-20T00:00:00Z

expirationDatestring | null(date-time)

The expiration date of the listing, in UTC/ISO 8601 format. Must not be before today or later than 30 days from today. Will default to after creation date if not supplied.

Example:2025-03-10T00:00:00Z

desiredDeliveryDatestring | null(date-time)

The desired delivery date of the listing, in UTC/ISO 8601 format. Must be equal or greater than availableDate and not before today or later than 30 days from today (optional).

Example:2025-03-04T00:00:00Z

partnerReferenceIdstring | null

A user supplied ID used for reference.

<= 50 characters

Example:969175d4-a3f8-4e43-b64f-a95d77475aa0

priceobject

Details of the price.

Show Child Parameters
slaobject

Details of the service level agreement (SLA) for a listing. Only required for listings in marketplaces allowing digital offers. Currently only applicable to private marketplaces.

Show Child Parameters
stopsarray[object]

Details of a stop.

Show Child Parameters
vehiclesarray[object]

Details of a vehicle.

Show Child Parameters
marketplacesarray[object]

Details of a marketplace.

Show Child Parameters
tagsarray | null[object]

Details of a tag.

Show Child Parameters
transportationReleaseNotesstring | null

Displayed in Central Dispatch website/app as “Transport Special Instructions”, these are specific guidelines or details for the safe and efficient pick up, delivery, or transportation of a load. This may contain sensitive data and is not available prior to acceptance of terms by a carrier.
Rules: This information is visible only to the assigned carrier after the load is dispatched and remains editable at any time.

Example:You will need special clearance to get in the lot. Call Jean at 303-999-1212.

Response

No Content. Successful request.

put/listings/id/{id}

Body

{ "shipperOrderId": "123-abc 900", "externalId": "RND10 CHEV", "trailerType": "OPEN", "loadSpecificTerms": "Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.", "availableDate": "2025-02-20T00:00:00Z", "expirationDate": "2025-03-10T00:00:00Z", "desiredDeliveryDate": "2025-03-10T00:00:00Z", "partnerReferenceId": "ORD-2023-0001", "price": { "total": 500, "cod": { "amount": 200, "paymentMethod": "CASH_CERTIFIED_FUNDS", "paymentLocation": "PICKUP" }, "balance": { "amount": 300, "paymentTime": "IMMEDIATELY", "balancePaymentMethod": "CASH", "balancePaymentTermsBeginOn": "PICKUP" } }, "sla": { "duration": "P2D", "timeZoneOffset": "-7:00", "rolloverTime": "19:00:00", "includeCurrentDayAfterRollOver": true }, "stops": [ { "stopId": "4e2efc84-6add-435c-9f12-8b19e3e5ba21", "stopNumber": 1, "locationName": "ABC Cars lot", "address": "345 W Elm St.", "city": "Anaheim", "state": "CA", "postalCode": "92802", "country": "US", "phone": "949-555-1323", "contactName": "Mickey Smith", "contactPhone": "949-555-2434", "geoCode": { "longitude": -117.91836265987132, "latitude": 33.81228788622535 }, "locationType": "Dealership" }, { "stopId": "9b6e0fad-8722-4da1-907c-f9522c04ef12", "stopNumber": 2, "locationName": "XYZ Inc.", "address": "255 Sands Ave.", "city": "Las Vegas", "state": "NV", "postalCode": "89169", "country": "US", "phone": "702-555-0101", "contactName": "Dean Vega", "contactPhone": "702-555-1212", "geoCode": { "longitude": -115.16195281104913, "latitude": 36.121343020081525 }, "locationType": "Dealership" } ], "vehicles": [ { "pickupStopNumber": 1, "dropoffStopNumber": 2, "vehicleId": "b331c130-e89b-12d3-a456-426614174000", "externalVehicleId": "EXT123456", "vin": "KL8CH6SA6NC001234", "year": 2022, "make": "Chevrolet", "model": "Spark", "trim": "LS", "vehicleType": "CAR", "color": "Red", "licensePlate": "B314PIE", "lotNumber": "LOT789", "isInoperable": false, "tariff": 1030.5, "additionalInfo": "The vehicle is in the back of the lot behind the big tree.", "shippingSpecs": { "height": 58, "width": 62, "length": 143, "weight": 2246 } } ], "marketplaces": [ { "priorityId": 1, "marketplaceId": 10000, "digitalOffersEnabled": true, "searchable": true, "offersAutoAcceptEnabled": true, "autoDispatchOnOfferAccepted": true, "predispatchNotes": "In order to pick up the keys you will have to walk through a lot with a big dog that protects it, he's chained but will bark at you.", "customersExcludedFromOffers": [ "157a16f0-503d-4256-ba60-a4876e8eb9bb" ] } ], "tags": [ { "name": "The number one", "value": "1d1d1d1d-e89b-12d3-a456-426614174000" } ], "transportationReleaseNotes": "You will need special clearance to get in the lot. Call Jean at 303-999-1212." }