Skip to main content

Expected Time to Dispatch (v2)

The POST /api/v2/recommended-price response now includes an estimated time-to-dispatch range, giving you a sense of how quickly a load is expected to book on the lane.

What's New in the v2 Response

Two new fields are added to data:

  • min_expected_time_to_dispatch — lower estimate of how long the load is expected to take to dispatch (book), in hours, based on comparable recent moves on the lane.
  • max_expected_time_to_dispatch — upper estimate of the same, in hours.

Both fields are nullable and may be null when there is insufficient data for the lane. The change is additive — existing fields are unchanged, so no action is required to keep your integration working.

Example Response

{
"meta": { "status": "success" },
"data": {
"price": 1272,
"price_per_mile": 0.88,
"distance_miles": 1450,
"volume": 42,
"confidence": 69,
"price_range_lower": 1150,
"price_range_upper": 1400,
"min_expected_time_to_dispatch": 1.5,
"max_expected_time_to_dispatch": 6.0,
"recent_moves": []
}
}

Refer to the "Recommended Price (v2)" section in the Pricing Insights API reference for the full request and response schema.

Enriched Recommended Price (v2)

We are introducing POST /api/v2/recommended-price, an enriched version of the Recommended Price endpoint. It returns the same recommended price as v1, plus richer market context to support pricing decisions.

The request body is unchanged from v1, so migrating is a one-line URL change from /api/v1/recommended-price to /api/v2/recommended-price.

What's New in the v2 Response

In addition to every field returned by v1 (price, price_per_mile, distance_miles, confidence, volume), the v2 response adds:

  • price_range_lower / price_range_upper — a recommended price range derived from comparable recent moves on the lane.
  • recent_moves — a list of recent comparable moves (route, prices, status, dates, and vehicles) that informed the recommendation.

Example Response

{
"meta": { "status": "success" },
"data": {
"price": 1272,
"price_per_mile": 0.88,
"distance_miles": 1450,
"volume": 42,
"confidence": 69,
"price_range_lower": 1150,
"price_range_upper": 1400,
"recent_moves": [
{
"delivered_date": "2026-04-28",
"dispatched_date": "2026-04-27",
"posting_date": "2026-04-27",
"price": 400.0,
"posted_price": 325.0,
"status": "invoiced",
"pickup_city": "Reno",
"pickup_state": "NV",
"delivery_city": "Gardena",
"delivery_state": "CA",
"distance_miles": 490,
"vehicles": [
{
"type": "sedan",
"year": 2023,
"make": "toyota",
"model": "camry",
"is_inoperable": false,
"requires_enclosed_trailer": false
}
]
}
]
}
}

Refer to the "Recommended Price (v2)" section in the Pricing Insights API reference for the full request and response schema.