With the Vehicle Check capability on Auto Trader Connect, you can do a full vehicle check using our Vehicles API.
Vehicle Check is our provenance data which can be used to query the history of a vehicle. There are 10 checks and where an issue is highlighted, further detail will be provided on the report.
Here’s a full list of the functionality:
- Full vehicle check
- Vehicle check report
Full vehicle check
As part of this capability, you’ll be able to access the vehicle check data via the Vehicles API.
To access this, you’ll need to make a GET request to the Vehicles API with:
- The Auto Trader advertiser ID of the dealer the request is for
- The VRM in the registration query parameter
- The query string parameter fullVehicleCheck=true
If successful, you’ll get a response that contains the vehicle data and all the provenance data for that vehicle.
Some examples of data that is returned for the requested vehicle:
- Mileage discrepancies
- Outstanding finance
- Plate changes
- Police stolen markers
Learn more about the data returned for a vehicle check
This should not be called multiple times for the same vehicle, as the data is unlikely to change and is also against our Vehicle Check fair usage policy.
Dealers can report any errors to our Vehicle Check team at vehicle.check@autotrader.co.uk. Any corrections will be shown within 24 hours after we have confirmed a resolution.
Check out an example of a Vehicles API call for a vehicle check
Vehicle check report
As part of this capability, you can access a vehicle check report.
This will contain the same data as the JSON object covered above but in a formatted PDF document.
To access this, you must make a GET request on the URL returned in the report attribute of the check object returned on the initial Vehicles API call.
Check out an example of a Vehicle Check Report API 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.