With the Trended Valuations capability on Auto Trader Connect, you will have access to our Valuations API to get a series of historic, current and future valuations for a vehicle.
Here is a list of all the functionality you have access to as part of this capability:
- Retrieve trended valuations
- Feature-adjusted trended valuations
- Condition-adjusted trended valuations
Retrieve trended valuations
As part of this capability, you will have access to our trended valuations via the Valuations API.
To get this, you’ll need to make a POST request to the Valuations API on the trended valuations endpoint with:
- The Auto Trader advertiser ID of the customer the request is for
- The payload of the POST request will need to include:
- The vehicle’s derivative ID
- The vehicle’s first registration date
- An object that determines the set of valuations returned for that vehicle which includes:
- The markets you would like valuations for, e.g. retail, part-exchange
- The frequency of valuations returned, e.g. daily, weekly, monthly
- The start date for the valuations and the mileage of the vehicle on the start date
- The end date for the valuations and the mileage of the vehicle on the end date
If successful, you’ll get a JSON object that contains an array of valuations. Each valuation in the array will have the date and mileage that the valuation has been based on. These valuations will be adjusted for features or condition and are all based on the market average.
Condition-adjusted trended valuations
To get a condition-adjusted trended valuations for a vehicle, add one of the following condition ratings to the payload of your POST request:
- Excellent
- Great
- Good
- Fair
- Poor
For details on when each of these ratings should be used, check out our API developer documentation.
Feature-adjusted trended valuations
To get a feature-adjusted trended valuations for a vehicle, add a list of features in an array in the payload of your Valuations API POST request.
This should be a list of all standard and optional features that are on the vehicle.
If you pass an empty array of features, you will receive the base valuation for that derivative which is the valuation if there are no features that increase the value of the vehicle.
Check out examples of trended valuations API calls
Error handling
When using the APIs above, you may get error response codes that you need to handle. This makes sure you have a smooth service for both you, as a partner, and your end user.