With the Historic Valuations capability on Autotrader Connect, you will be able to access market average vehicle valuations for up to 540 days in the past.
Here's a full list of the functionality:
- View historic valuation
View historic valuation
Using the Historic Valuations API, you can see Autotrader’s previous market average valuations for a vehicle.
To get these valuations, you will need to send a POST request with the following data:
- The historic date you want a valuation for
- The vehicle’s derivative ID
- The vehicle’s first registration date
- The estimated mileage of the vehicle on the date you are requesting valuations for
The historic date provided must be no more than 540 days in the past, and should be after the first registration date of the vehicle. In sandbox, the historic date must be no more than 3 months in the past.
If available, this will return trade and retail valuations for the requested data. If we do not have historic valuations for the requested data, we will return null values.
Valuations returned by the Historic Valuations API will be market averages. This can’t be adjusted for the vehicle’s condition or features.
Check out examples of Historic 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.