Valuations API

Base URLs

Production

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

---

Valuations Lookup

Get Vehicle Valuations by TokenID

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

Retrieves current valuation of a vehicle.

Path Parameters

Name	Type	Description
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT.

Headers

Name	Type	Description
Authorization*	String	Vehicle JWT in Bearer Authentication format.

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}/v2/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
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT.

Headers

Name	Type	Description
Authorization*	String	Vehicle JWT in Bearer Authentication format.

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}/v2/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
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT.

Headers

Name	Type	Description
Authorization*	String	Vehicle JWT in Bearer Authentication format.

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"
}

Entity Types

Valuation

A valuation provided by a 3rd party service to determine the value of a given vehicle. This is based on vehicle make, model, year, and odometer reading - if for some reasons that the valuation cannot be determined based on the odometer readings of your vehicle, DIMO defaults to the valuation from 12,000 annual mileage.

Offer

An offer provided by a 3rd party service to determine the offer extended to a given vehicle. This is based on vehicle make, model, year, and odometer reading - if for some reasons that the offer cannot be determined based on the odometer readings of your vehicle, DIMO defaults to the offer from 12,000 annual mileage.