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

Get Valuations: Data SDK Function Calls

TypeScript

await dimo.Valuations.getValuations({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.get_valuations(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetValuationsAsync(
    accessToken,
    tokenId
);

---

Offers Lookup

Submit a Vehicle Offers Request by Token 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"
}

Offers Lookup: Data SDK Function Calls

TypeScript

await dimo.Valuations.getInstantOffers({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.offers_lookup(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetInstantOfferAsync(
    accessToken,
    tokenId
);

List Vehicle Offers by User Token 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"
}

List Vehicle Offers: Data SDK Function Calls

TypeScript

await dimo.Valuations.getOffers({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.list_vehicle_offers(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetOffersAsync(
    accessToken,
    tokenId
);

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.