Valuations

Get instant offers and valuations for vehicles.

Overview

The Valuations API provides real-time vehicle valuation data and purchase offers from third-party services using vehicle token IDs. The API delivers comprehensive vehicle valuations including trade-in and retail values from providers like Drivly, as well as instant purchase offers from services such as Carvana, CarMax, and Vroom. Valuations and offers are calculated based on the vehicle's make, model, year, and odometer readings. If for some reason the valuation cannot be determined based on the odometer reading of a vehicle, DIMO defaults to the valuation from 12,000 annual mileage.

Base URL

https://valuations-api.dimo.zone

Endpoints

Get a vehicle valuation

Retrieves current valuation of a vehicle.

Parameters

tokenIdintegerRequired

The Vehicle ID that you are requesting permission to. This is an integer that indicates the vehicle you are inquiring about.

GET/v2/vehicles/:tokenId/valuations

const valuations = await dimo.Valuations.getValuations({
  vehicleJwt: "eyJhbGc...ILlujqw",
  tokenId: 123456
})

Response

{
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'
  }
]
}

Submit a vehicle offers request

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).

Parameters

tokenIdintegerRequired

The Vehicle ID that you are requesting permission to. This is an integer that indicates the vehicle you are inquiring about.

POST/v2/vehicles/:tokenId/instant-offer

const instantOffer = await dimo.Valuations.getInstantOffers({
  vehicleJwt: "eyJhbGc...ILlujqw",
  tokenId: 123456
})

Response

{}

List vehicle offers

Lists existing unexpired offers for a given vehicle that was retrieved in a prior submission of the Valuations API. If offers expired, this endpoint will not return any results.

Parameters

tokenIdintegerRequired

The Vehicle ID that you are requesting permission to. This is an integer that indicates the vehicle you are inquiring about.

GET/v2/vehicles/:tokenId/offers

const instantOffer = await dimo.Valuations.getOffers({
  vehicleJwt: "eyJhbGc...ILlujqw",
  tokenId: 123456
})

Response

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