Valuations Endpoints

Base URLs

Production

https://valuations-api.dimo.zone/

---

Valuations Lookup 🔐

Get Vehicle Valuations by TokenID

GET {baseUrl}/v1/vehicles/{tokenId}/valuations

Retrieves current valuation of a vehicle.

Path Parameters

Name	Type	Description

Headers

Name	Type	Description

200: Success

{
  valuationSets: [
    {
      vendor: 'drivly',
      updated: '2024-03-17T02:37:50Z',
      mileage: 36000,
      tradeInSource: 'drivly',
      tradeIn: 28824,
      tradeInAverage: 28824,
      retailSource: 'drivly',
      retail: 33097,
      retailAverage: 33097,
      odometerUnit: 'miles',
      odometer: 36000,
      odometerMeasurementType: 'Estimated',
      userDisplayPrice: 30960,
      currency: 'USD'
    }
  ]
}

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

---

Offers Lookup 🔐

Submit a Vehicle Offers Request by User Device ID

POST {baseUrl}/v1/vehicles/{tokenId}/instant-offer

Submits an offer request to 3rd party services such as Carvana, Carmax, and Vroom. Note that this endpoint will refresh the existing unexpired offers (if any).

Path Parameters

Name	Type	Description

Headers

Name	Type	Description

200: Success

400: Bad Request

No offers found for you vehicle in last request

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

List Vehicle Offers by User Device ID

GET {baseUrl}/v1/vehicles/{tokenId}/offers

Lists existing unexpired offers for a given vehicle that was retrieved in a prior submission of#get-a-vehicle-instant-offer-by-user-device-id. If offers expired, this endpoint will not return any results.

Path Parameters

Name	Type	Description

Headers

Name	Type	Description

200: Success

{
  offerSets: [
    {
      source: 'drivly',
      updated: '2024-02-01T03:11:09Z',
      odometerMeasurementType: 'Estimated',
      offers: [Array]
    }
  ]
}

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

---

Swagger Doc

Swagger UI

Valuations API Swagger Doc