Stage - Offer API

Offer API

1.0.0OAS 3.0

Central Dispatch’s Offer API allows shippers and brokers to manage offers made to carriers for listings. This API provides functionalities for creating, updating, and retrieving offers, ensuring that shippers and brokers can efficiently handle the negotiation and acceptance processes.

This API also supports Preferred Carrier Offers, which let a Premium Public Shipper send an offer directly to a specific carrier in their preferred network on an eligible V2 listing. See the Start Negotiation and Revoke an Offer endpoints below for Preferred Carrier Offer eligibility, workflow, and error details.
🔑 Scope: offers_api

API Base URL
  • Server 1:https://prod-offers-api.awscal2.manheim.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)

Negotiations

Start Negotiation

Initiate an offer negotiation on a listing.

📝 Important Notes

  • 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.
  • The response will include an ETag header, which should be used for the If-Match header in subsequent updates.

🎯 Preferred Carrier Offers

A Premium Public Shipper (an active Premium Dealer/Broker subscription in the Public Marketplace, marketplaceId 10000) can use this endpoint to send a Preferred Carrier Offer directly to a specific carrier in their preferred network by supplying carrierId. The stricter Preferred Carrier Offer rules below apply only when the listing is a V2 listing (listingId >= 300000000), the request’s marketplaceId is a Public Marketplace, and the listing is non-searchable (not shown on the load board); direct offers on listings outside those conditions are processed as standard negotiations.

For a qualifying listing:

  • Single Public Marketplace only — listings linked to multiple marketplaces are rejected.
  • SLA: duration, time zone, rollover time.
  • Stops (for both origin and destination): address, city, state, zip code, location type, contact name, contact phone.

For the preferred offer being created:

  • amount must exactly equal the listing’s price.total — no other value is accepted.
  • expirationDateTime must not exceed the listing’s expirationDate, if one is set.
  • carrierId must be in the shipper’s preferred carrier network.
  • At most 5 active (AWAITING_CARRIER) offers per listing.
post
https://prod-offers-api.awscal2.manheim.com/negotiations

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

Body

application/json

InitiateNegotiationModel

InitiateNegotiationModel

Details of a negotiation.

listingIdstring

The ID of the listing.

Example:42220470

carrierIdstring | null(uuid)

The ID of the Central Dispatch customer the shipper wants to move cars in the dispatch. If a shipper is making the offer this is required. For a Preferred Carrier Offer, this must be a carrier in the shipper’s preferred carrier network.

Example:0ca91a43-fbee-4c05-9a6c-aa5c63888f5c

amountnumber(double)

The balance amount that will be due after the COD/COP payment is applied.

>= 0

Example:300

pickupDatestring | null(date-time)

The date the pick up is scheduled, in UTC/ISO 8601 format. Will default to the listing pick up date if not specified.

Example:2025-09-27T00:00:00.000Z

deliveryDatestring | null(date-time)

The desired delivery date of the listing, in UTC/ISO 8601 format. Will default to the listing delivery date if not specified.

Example:2025-10-04T00:00:00.000Z

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

expirationDateTimestring(date-time)

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

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

Response

Created. Successful request.

post/negotiations

Body

{ "amount": 300, "carrierId": "0ca91a43-fbee-4c05-9a6c-aa5c63888f5c", "deliveryDate": "2025-10-04T00:00:00.000Z", "expirationDateTime": "2025-11-20T00:00:00.000Z", "listingId": "42220470", "marketplaceId": 10000, "pickupDate": "2025-09-27T00:00:00.000Z" }