When creating a stock record, it's recommended that all data points returned in the vehicle or taxonomy lookup are sent. However, there'll be instances when the data returned is incomplete and not enough to complete the stock item.
For trucks, you can use the Taxonomy API to get the data you need:
Start by requesting the style, sub-style, make and model
Using the parameters and selected values, you can follow this up with body types, cab types, axle configurations etc.
The list of all of our taxonomy facets is available in our developer documentation
The table below shows the fields needed for stock creation, those you can edit via the API, what's editable in Portal and whether it's a search filter on Autotrader. Everything's editable via the API.
| Vehicle data field | Needed for stock creation | Editable via the API | Editable in Portal | Search filter on Autotrader |
| ownershipCondition | ✓ | ✓ | ✓ | ✓ |
| vehicleType | ✓ | ✓ | ✓ | ✓ |
| registration | ✓ | ✓ | ✓ | |
| vin | ✓ | ✓ | ✓ | |
| engineNumber | ✓ | ✓ | ||
| make* | ✓ | ✓ | ✓ | ✓ |
| model* | ✓ | ✓ | ✓ | ✓ |
| derivative | ✓ | ✓ | ✓ | |
| bodyType* | ✓ | ✓ | ✓ | ✓ |
| fuelType* | ✓ | ✓ | ✓ | ✓ |
| transmissionType* | ✓ | ✓ | ✓ | ✓ |
| seats | ✓ | ✓ | ✓ | ✓ |
| drivetrain | ✓ | ✓ | ✓ | ✓ |
| badgeEngineSizeLitres | ✓ | ✓ | ✓ | ✓ |
| badgeEngineSizeCC | ✓ | ✓ | ✓ | ✓ |
| engineCapacityCC | ✓ | ✓ | ✓ | ✓ |
| enginePowerBHP | ✓ | ✓ | ✓ | ✓ |
| enginePowerPS | ✓ | ✓ | ✓ | ✓ |
| fuelCapacityLitres | ✓ | ✓ | ✓ | |
| emissionClass | ✓ | ✓ | ✓ | |
| owners | ✓ | ✓ | ✓ | ✓ |
| firstRegistrationDate | ✓ | ✓ | ✓ | ✓ |
| colour | ✓ | ✓ | ||
| style* | ✓ | ✓ | ✓ | ✓ |
| subStyle* | ✓ | ✓ | ✓ | ✓ |
| minimumKerbWeightKG | ✓ | ✓ | ||
| grossVehicleWeightKG | ✓ | ✓ | ✓ | |
| odometerReadingMiles | ✓ | ✓ | ||
| motExpiryDate | ✓ | ✓ | ||
| serviceHistory | ✓ | ✓ | ||
| plate | ✓ | ✓ | ✓ | ✓ |
| yearOfManufacture | ✓ | ✓ | ✓ | ✓ |
| interiorCondition | ✓ | ✓ | ||
| tyreCondition | ✓ | ✓ | ||
| bodyCondition | ✓ | ✓ | ||
| previousOwner | ✓ | ✓ | ✓ | |
| v5Certificate | ✓ | ✓ | ||
| driverPosition | ✓ | ✓ | ✓ | |
| alxeConfiguration* | ✓ | ✓ | ✓ | ✓ |
| lastServiceOdometerReadingMiles | ✓ | ✓ | ||
| lastServiceDate | ✓ | ✓ |