With the Vehicle Taxonomy capability on Autotrader Connect, you will have access to our vehicle data and taxonomy via a VRM lookup.
Here's a full list of the functionality:
- Vehicle Registration Lookup
- Vehicle MOT test data
- Vehicle history
- Vehicle charge times
- Taxonomy Lookup
- Taxonomy technical data
- Taxonomy prices
Vehicle Registration Lookup
As part of this capability, you’ll be able to access our vehicle data via the Vehicles API.
To retrieve this, you’ll need to make a GET request to the Vehicles API with:
- The Autotrader advertiser ID of the dealer the request is for
- The VRM in the registration query parameter
If successful, you’ll get a JSON object that contains our data for the vehicle. This may be full or partial data, depending on what we have for that vehicle.
If we don’t have data for that registration, you’ll get a 404 response code.
Vehicle MOT Test Data
To get MOT test data for a vehicle, add the query string parameter motTests=true to your Vehicles API request.
Vehicle History
To get this, add the query string parameter history=true to your Vehicles API request.
We can provide the following basic history about a vehicle:
- Scrapped
- Stolen
- Imported or exported
- The number of previous owners
- An array of keeper changes
- An array of V5C issue dates
Vehicle Charge Times
For electric vehicles you can get charge time data. Just add the chargeTimes=true query string parameter to the Vehicles API request.
Check out examples of Vehicle API call
Taxonomy Lookup
Also as part of this capability, you’ll be able to access our taxonomy data via the Taxonomy API. It allows you to navigate through our data to get a derivative ID for a given vehicle. You'll be able to find:
- Makes
- Models
- Generations
- Derivatives
You may need to use this if you try to look up a registration on the Vehicles API, but it doesn’t return a derivative ID. This means that we either have no data or only partial data for that registration.
Check out examples of Taxonomy API calls
Taxonomy Technical Data
Once you have a derivative ID, you can use it to get our technical specification data for that derivative.
Check out an example of a technical data call
Taxonomy Prices
With a derivative ID, you can get base and delivery prices from the manufacturer. These prices are for that derivative from when the vehicle was new. This can return the price for a given date, or all the price history for that vehicle.
Check out an example of a taxonomy price call
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.