Valuations API Endpoints

Base URLs

Dev

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

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
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT. A prerequisite is to obtain a token that is permitted to access trips data for this specific vehicle.

Headers

Name	Type	Description
Authorization*	String	Bearer authentication using the token generated from the Token Exchange.

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
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT. A prerequisite is to obtain a token that is permitted to access trips data for this specific vehicle.

Headers

Name	Type	Description
Authorization*	String	Bearer authentication using the token generated from the Token Exchange.

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
tokenId*	String	Vehicle token ID, this is the token ID of your vehicle NFT. A prerequisite is to obtain a token that is permitted to access trips data for this specific vehicle.

Headers

Name	Type	Description
Authorization*	String	Bearer authentication using the token generated from the Token Exchange.

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