With the Vehicle Equipment capability on Auto Trader Connect you’ll have access to our feature data via the Vehicles API, or for a derivative ID via the Taxonomy API.
This includes factory fitted features for selected manufacturers.
Here’s a full list of the functionality:
- Vehicle Lookup Features
- Factory Fitted Features
- Taxonomy Features
Vehicle Lookup Features
As part of this capability, you’ll be able to access our feature data via the Vehicles API.
To get this, you’ll need to make a GET request to the Vehicles API with the Auto Trader Advertiser ID. Clearly request it for the VRM you include in the registration query parameter using the features=true query string parameter.
If successful, you’ll get a JSON object that has our vehicle data for that registration. There will be an array of all possible features on the vehicle. The dealer will then need to choose which features are on the vehicle.
If we do not have a derivative ID for that registration, the features attribute will be an empty array. All our features are based off of the derivative ID.
If we do not have any data for that registration, you’ll get a 404 response code.
Factory Fitted Features
For each feature returned in the feature array, there will be a factory fitted attribute. This can be used to figure out if that particular feature was fitted at the manufacturer’s factory.
- For standard features:
- This value will be null, as we assume all standard features were fitted at the factory.
- For optional features:
- If the value is true, this means Auto Trader has been told by the manufacturer that the feature was fitted at the factory for that vehicle.
- If the value is false, this means the manufacturer has told us the feature was not fitted at the factory for that vehicle.
- If the value is null, then we do not have factory fitted data for that vehicle, possibly because we don’t have a relationship with that manufacturer.
Check out examples of Vehicles API calls for features
Taxonomy Features
As part of this capability, you will be able to access our feature data via the Taxonomy API.
You may need to use this if you try to look up a registration on the Vehicles API and it:
- Does not return a derivative ID
- Returns no data at all
- Or if we have a derivative ID for the vehicle, but no feature data
Once you get a derivative ID, you can get all of the possible features for that derivative. The dealer will need to select which features are on the vehicle.
This will not have any factory fitted data, as this lookup returns the possible features for that derivative ID in general. It will not give you details for a specific vehicle.
Check out an example of how to navigate the Taxonomy API for features
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.