Skip to main content

Quickstart

This guide walks you through making your first Recommended Price request.

Prerequisites​

1. Make a Request​

Send a POST request with your route and vehicle details. You must provide either a ZIP code, or a city and state, for each location.

curl -X POST "https://pricing-insights.superdispatch.com/api/v1/recommended-price" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "trailer_type": "open",
    "pickup": { "city": "Reno", "state": "NV" },
    "delivery": { "city": "Gardena", "state": "CA" },
    "vehicles": [
      {
        "type": "sedan",
        "make": "Toyota",
        "model": "Camry",
        "year": "2023",
        "is_inoperable": false
      }
    ]
  }'

2. Read the v1 Response​

{
  "meta": { "status": "success" },
  "data": {
    "price": 1272,
    "price_per_mile": 0.88,
    "distance_miles": 1450,
    "confidence": 69,
    "volume": 42
  }
}

3. Get Richer Context with v2​

Switch the URL to /api/v2/recommended-price — the request body is unchanged — to also receive a recommended price range and recent comparable moves.

curl -X POST "https://pricing-insights.superdispatch.com/api/v2/recommended-price" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": { "city": "Reno", "state": "NV" },
    "delivery": { "city": "Gardena", "state": "CA" },
    "vehicles": [
      { "type": "sedan", "make": "Toyota", "model": "Camry", "year": "2023", "is_inoperable": false }
    ]
  }'
{
  "meta": { "status": "success" },
  "data": {
    "price": 1272,
    "price_per_mile": 0.88,
    "distance_miles": 1450,
    "confidence": 69,
    "volume": 42,
    "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 }
        ]
      }
    ]
  }
}

Next Steps​