Listings API V2

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

PriceRequest

object

Details of the price.

totalnumber(double)

The total amount to be paid for completing the dispatch.

>= 0.01

Example:500

totalCurrencystring

The currency of the monetary field.

Allowed values:USD

Default:USD

Example:USD

codobject

Details of the cash on delivery or cash on pick-up (COD/COP).

Show Child Parameters
balanceobject

Details of the balance.

Show Child Parameters
Example

PriceResponse

object

Details of the price.

totalnumber(double)

The total amount to be paid for completing the dispatch.

Example:500

totalCurrencystring

The currency of the monetary field.

Allowed values:USD

Default:USD

Example:USD

codobject

Details of cash on delivery or cash on pick up (COD/COP).

Show Child Parameters
balanceobject

Details of the balance.

Show Child Parameters
Example

ShippingSpecsRequest

object

Details of the shipping specifications of a vehicle.

heightnumber(double)

The height of the vehicle. If the value is not sent it will be completed based on the vehicle information if available.

Default:0

Example:58

widthnumber(double)

The width of the vehicle.

Default:0

Example:62

lengthnumber(double)

The length of the vehicle.

Default:0

Example:143

weightnumber(double)

The weight of the vehicle.

Default:0

Example:2246

Example

ShippingSpecsResponse

object

Details of the shipping specifications of a vehicle.

heightinteger(int32)

The height of the vehicle.

Example:58

widthinteger(int32)

The width of the vehicle.

Example:62

lengthinteger(int32)

The length of the vehicle.

Example:143

weightinteger(int32)

The weight of the vehicle.

Example:2246

Example