Listings API V2

ListingResponse

object

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

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(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(date-time)

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

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

desiredDeliveryDatestring(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

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.

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

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

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

A user supplied ID used for reference.

Example:25-KL8CH6

priceobject

Details of the price.

Show Child Parameters
shipperOrderIdstring

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[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

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.

Example

ListingStatus

string

The status of the listing.

Allowed values:ACTIVEARCHIVEDDELETED

Example

LocationType

string

The facility type of the stop.

Allowed values:UnspecifiedAirportRentalCenterAuctionAuctionSatelliteLotCommercialBusinessCorporateOfficePlantCrossDockSatelliteStagingLotDealershipImpoundMarshallingYardMilitaryBaseMobileAuctionPortRailYardReconFacilityRentalCarRetailSiteRepoResidenceServiceCenterConsumerMovesTerminalOtherMechanicShopWarehouseParkingLot

Default:Unspecified

Example

MarketplaceRequest

object

Details of a marketplace.

marketplaceIdinteger(int32)

The ID of the Central Dispatch Marketplace. There are three types of Marketplaces:

  • Public: The public Marketplace ID is 10000.
  • Test: Test Marketplace IDs will be provided to you by Central Dispatch.
  • Private: Private Marketplace IDs will be provided to you by Central Dispatch, if necessary.

Example:10000

digitalOffersEnabledboolean

Indicates whether digital offers are enabled for this Marketplace on this listing. Digital offers functionality is currently only available for select private Marketplaces. When true the following are required:

  • sla is required.
  • stops address is required.
  • vehicles all vehicles must have VIN.

Default:false

Example:true

searchableboolean

Controls whether the listing appears in Marketplace search results. Allows listings to be posted but not publicly searchable. When true: listing is visible and searchable on this Marketplace. When false: listing is hidden from Marketplace search.

Default:false

Example:true

offersAutoAcceptEnabledboolean

Allows carrriers to digitially accept an offer. The button will be visible for this Marketplace on this listing. Requires digitalOffersEnabled to be true.

Default:false

autoDispatchOnOfferAcceptedboolean

Automatically creates dispatch when an offer is accepted.

Default:false

Example:true

predispatchNotesstring

Provides general preparation instructions for shipments. This should not contain sensitive data as it is made available prior to acceptance of terms by a carrier.
Rules: This information will always be visible to carriers, and it will no longer be editable once the load is dispatched.

<= 500 characters

Example: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.

customersExcludedFromOffersarray[string](uuid)

A collection of customer IDs excluded from offers. Maximum count of 200.

Example:d5c62b14-cbd1-11ee-9a0e-0242ac110002, 157a16f0-503d-4256-ba60-a4876e8eb9bb

makeOffersEnabledboolean

Allows carriers to make an offer on the listing. The button will be visible for this Marketplace on this listing. Requires digitalOffersEnabled to be true. Defaults to the value of digitalOffersEnabled if null.

Example:true

Example

MarketplaceResponse

object

Details of the marketplace.

autoDispatchOnOfferAcceptedboolean

Automatically creates dispatch when an offer is accepted.

Example:true

customersExcludedFromOffersarray[string](uuid)

A collection of customer IDs excluded from offers.

Example:d5c62b14-cbd1-11ee-9a0e-0242ac110002, 157a16f0-503d-4256-ba60-a4876e8eb9bb

digitalOffersEnabledboolean

Indicates whether digital offers are enabled for this Marketplace on this listing. Digital offers functionality is currently only available for select private Marketplaces.

Example:true

marketplaceIdinteger(int32)

The ID of the Central Dispatch Marketplace. There are three types of Marketplaces:

  • Public: The public Marketplace ID is 10000.
  • Test: Test Marketplace IDs will be provided to you by Central Dispatch.
  • Private: Private Marketplace IDs will be provided to you by Central Dispatch, if necessary.

Example:10000

offersAutoAcceptEnabledboolean

Allows carrriers to digitially accept an offer. The button will be visible for this Marketplace on this listing. Requires digitalOffersEnabled to be true.

Example:true

predispatchNotesstring

Provides general preparation instructions for shipments. This should not contain sensitive data as it is made available prior to acceptance of terms by a carrier.
Rules: This information will always be visible to carriers, and it will no longer be editable once the load is dispatched.

Example: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.

searchableboolean

Controls whether the listing appears in Marketplace search results. Allows listings to be posted but not publicly searchable. When true: listing is visible and searchable on this Marketplace. When false: listing is hidden from Marketplace search.

Example:true

makeOffersEnabledboolean

Allows carriers to make an offer on the listing. The button will be visible for this Marketplace on this listing. Requires digitalOffersEnabled to be true.

Example:true

Example