Market Itelligence
Get Listing Prices
Gets predicted pricing and historical data about listings, dispatches and pricing given a load with similar vehicle, origin and destination.
👥 Applicable Roles
- Enterprise Package Customers
📝 Important Notes
- Stops array must include two valid stops.
- Stop numbers must increment sequentially starting from one.
- Each stop requires either valid latitude and longitude coordinates (most accurate) or city and state. Try to include street address and country if latitude and longitude coordinates are not available. The more information provided the more accurate the results will be.
- Origin and destination stops cannot be the same.
- The vehicles array must include one valid vehicle entry.
- Both
pickUpStopNumberanddropOffStopNumberare required and must correspond to stop numbers in the stops array (typically 1 and 2). - When
enforceEnclosedOnlyis set totruein the request, every comparable listing returned will haveisEnclosedset totrue. TheisEnclosedandinoperablefields are returned on every comparable listing regardless of the request flags.
post
https://api.centraldispatch.com/market-intelligence/list-prices
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
Body
application/json
ListingPriceRequest
ListingPriceRequest
Details of listing prices.
stopsarray[object]
Details of a stop.
Show Child Parameters
vehiclesarray[object]
Details of a vehicle.
Show Child Parameters
isEnclosedboolean
Limit search to enclosed trailers.
Default:false
Example:true
enforceEnclosedOnlyboolean | null
When true, strictly limits search results to fully enclosed items only. By default, the search relaxes enclosed requirements to improve match rates, but enabling this flag ensures no non-enclosed results are returned.
Default:false
Example:true
limitinteger | null(int32)
The maximum number of items to be returned in the response.
Default:5
>= 1<= 5
Example:1
dateSincestring | null(date-time)
The earliest creation date for comparable listings to include in results. Accepts any date between today and the last 365 days. If not provided, defaults to 365 days ago, in UTC/ISO 8601 format.
Example:2026-03-20T00:00:00Z
Response
application/json
Response
application/json
OK. Successful request.
ListingPriceResponseCollection
A collection of listing price responses.
hrefstring | null
The URL used to query the current collection of the resource.
Example:https://api.centraldispatch.com/list-prices
countinteger(int32)
The total count of resources in the collection.
Example:1
limitinteger(int32)
The maximum number of items to be returned in the response.
Example:1
itemsarray | null[object]
Details of the listing price.
Show Child Parameters
post/market-intelligence/list-prices
Authentication
Headers
Body
{
"stops": [
{
"stopNumber": 1,
"streetAddress1": "345 W Elm St.",
"city": "Anaheim",
"state": "CA",
"postalCode": "92802",
"country": "US",
"latitude": 33.81228788622535,
"longitude": -117.91836265987132
},
{
"stopNumber": 2,
"streetAddress1": "255 Sands Ave.",
"city": "Las Vegas",
"state": "NV",
"postalCode": "89169",
"country": "US",
"latitude": 36.121343020081525,
"longitude": -115.16195281104913
}
],
"vehicles": [
{
"vin": "KL8CH6SA6NC001234",
"year": "2022",
"make": "Chevrolet",
"model": "Spark",
"isOperable": false,
"pickupStopNumber": 1,
"dropOffStopNumber": 2,
"vehicleType": "CAR"
}
],
"isEnclosed": true,
"enforceEnclosedOnly": true,
"limit": 1,
"dateSince": "2026-03-20T00:00:00Z"
}
application/json
Error
objectDetails of an error or issue.
codestring
The code used for the issue.
Example:resource.issue_type
messagestring
A detailed message.
Example:The issue happened because something is wrong.
propertystring
The property to which the issue is associated.
Example:person
propertiesobject
Additional properties related to the issue.
Example:{"firstName":"D0nn@","lastName":"Sm!th"}
Example
Errors
objectAn error occurred, and the request could not be completed.
errorsarray[object]
Details of an error or issue.
Show Child Parameters
Example
ListingPriceRequest
objectDetails of listing prices.
stopsarray[object]
Details of a stop.
Show Child Parameters
vehiclesarray[object]
Details of a vehicle.
Show Child Parameters
isEnclosedboolean
Limit search to enclosed trailers.
Default:false
Example:true
enforceEnclosedOnlyboolean
When true, strictly limits search results to fully enclosed items only. By default, the search relaxes enclosed requirements to improve match rates, but enabling this flag ensures no non-enclosed results are returned.
Default:false
Example:true
limitinteger(int32)
The maximum number of items to be returned in the response.
Default:5
>= 1<= 5
Example:1
dateSincestring(date-time)
The earliest creation date for comparable listings to include in results. Accepts any date between today and the last 365 days. If not provided, defaults to 365 days ago, in UTC/ISO 8601 format.
Example:2026-03-20T00:00:00Z
Example