Skip to main content

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.