Identify Technical Data and Features for any vehicle at a specific point in time.
The service can be used to obtain details for any vehicle for which the Auto Trader Derivative ID is already known, for example a vehicle valued as a part-exchange.
Includes free-to-use taxonomy endpoints if you need to build a manual vehicle selection.
Key features:
-
Basic vehicle information (upto 28 fields)
-
Insurance data
-
Performance data
-
Weights, dimensions and capacities
-
Engine data
-
EV data
-
OEM data
-
Standard Features
-
Optional Features
- From 1p per lookup
Includes free-to-use taxonomy endpoints for building a manual selection process
Pricing
| Plan | GBP | EUR | USD |
|---|---|---|---|
| PAYG (Per Use) | 3p | 4c | 5c |
| Business (Per Use) | 2p | 3c | 3c |
| Enterprise (Per Use) | 1p | 2c | 2c |
V2
Documentation
Introduction
This endpoint returns standard and optional items, a description of the vehicle, along with the vehicle's technical data. By using an effective date (optional parameter), you can return the pricing relevant to the chosen vehicle for that moment in time.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/autotrader/specandtechdatafromid?autotrader_derivative_id=9f058ca9d44c45dd95d692f0b803110a&effective_date=2018-11-19
Example Sandbox Request
https://sandbox.oneautoapi.com/autotrader/specandtechdatafromid?autotrader_derivative_id=9f058ca9d44c45dd95d692f0b803110a&effective_date=2018-11-19
Request Parameters
autotrader_derivative_id
mandatory, string, e.g. 9f058ca9d44c45dd95d692f0b803110a
Auto Trader identifier for the derivative of the vehicle
effective_date
optional, string, e.g. 2018-11-19
Return the pricing relevant to the chosen vehicle for that moment in time.
Sample Response
{
"success": true,
"result": {
"basic_vehicle_info": {
"country_of_origin": "United Kingdom",
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"autotrader_asset_type": "Car",
"vehicle_sector": "Supermini Conv",
"manufacturer_desc": "MINI",
"model_range_desc": "Convertible",
"generation_desc": "Convertible (2015 - 2018)",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"trim_level_desc": "Cooper",
"autotrader_body_type_desc": "Convertible",
"autotrader_fuel_type_desc": "Petrol",
"cab_type_desc": "Crew cab",
"autotrader_transmission_desc": "Manual",
"wheelbase_type_desc": "STD",
"roof_height_type_desc": "Low",
"autotrader_drivetrain_type_desc": "Front Wheel Drive",
"drive_type_desc": "4X2",
"number_seats": 4,
"number_doors": 2,
"number_gears": 6,
"number_axles": 2,
"derivative_desc": "1.5 Cooper Convertible (s/s) 2dr",
"long_derivative_desc": "1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"introduced_date": "2020-01-01",
"discontinued_date": "2020-01-01"
},
"insurance_data": {
"insurance_group_1to50": "22",
"insurance_security_code": "E"
},
"performance_data": {
"top_speed_mph": 123,
"0to60_mph": 12.3,
"0to100_kmph": 12.3
},
"weight_dimension_capacities_data": {
"vehicle_length_mm": 1234,
"vehicle_height_mm": 1234,
"vehicle_width_mm": 1234,
"vehicle_wheelbase_mm": 1234,
"bootspace_seats_up_litres": 123,
"bootspace_seats_down_litres": 123,
"payload_length_mm": 1234,
"payload_width_mm": 1234,
"payload_height_mm": 1234,
"payload_weight_kg": 123,
"payload_volume_cubicmetres": 123,
"min_kerbweight_kg": 1234,
"gross_vehicleweight_kg": 1234,
"gross_trainweight_kg": 1234
},
"engine_data": {
"engine_manufacturer": "MINI",
"engine_badged_size_litres": 1.2,
"engine_capacity_cc": 1234,
"engine_bore_mm": 12,
"engine_stroke_mm": 12,
"fuel_delivery": "Turbo Common Rail",
"fuel_capacity_litres": 12,
"number_cylinders": 3,
"cylinder_arrangement": "Inline",
"valve_gear": "Double Overhead Camshaft",
"valves": 12,
"power_ps": 123,
"power_bhp": 123.5,
"torque_nm": 123,
"torque_lbft": 123.45,
"emission_class": "Euro 6",
"is_rde_compliant": true,
"co2_gkm": 123,
"is_startstop": true,
"nedc_extra_urban_mpg": 12.3,
"nedc_urban_mpg": 12.3,
"nedc_combined_mpg": 12.3,
"wltp_low_mpg": 12.3,
"wltp_medium_mpg": 12.3,
"wltp_high_mpg": 12.3,
"wltp_extra_high_mpg": 12.3,
"wltp_combined_mpg": 12.3
},
"oem_data": {
"oem_manufacturer_desc": "MINI",
"oem_model_range_desc": "Convertible",
"oem_derivative_desc": "Cooper Convertible",
"oem_body_type_desc": "Convertible",
"oem_transmission_type_desc": "Manual",
"oem_drivetrain_desc": "Front wheel drive",
"oem_wheelbase_type_desc": "STD",
"oem_roof_height_type_desc": "Low",
"oem_engine_type_desc": "DIG-T",
"oem_engine_tech_desc": "TBC",
"oem_engine_desc": "58kWh",
"oem_edition_desc": "TBC",
"oem_colour": "Midnight Black"
},
"feature_data": [
{
"feature_desc": "12Volt Socket in Front Centre Console",
"feature_status": "Standard",
"feature_category": "Audio and Communications",
"list_price_ex_vat": 123.45,
"list_price_vat": 12.34,
"list_price_inc_vat": 123.45
}
]
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
country_of_origin
e.g. United Kingdom
Where the vehicle was made and manufactured.
autotrader_derivative_id
e.g. 1a2b345cf6d789ef1g0111h2i13j141k
The Auto Trader Derivative ID
autotrader_asset_type
e.g. Car
Auto Trader's asset type
vehicle_sector
e.g. Supermini Conv
The vehicle sector as defined by Auto Trader
manufacturer_desc
e.g. MINI
Manufacturer description
model_range_desc
e.g. Convertible
Model range description.
generation_desc
e.g. Convertible (2015 - 2018)
The generation description
vehicle_desc
e.g. MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)
The Vehicle description
trim_level_desc
e.g. Cooper
The trim level description
autotrader_body_type_desc
e.g. Convertible
Auto Trader's body type description
autotrader_fuel_type_desc
e.g. Petrol
Auto Trader's fuel type
cab_type_desc
e.g. Crew cab
Cab type (applicable to commercial vehicles).
autotrader_transmission_desc
e.g. Manual
Auto Trader's transmission description
wheelbase_type_desc
e.g. STD
Wheelbase type.
roof_height_type_desc
e.g. Low
The roof height description
autotrader_drivetrain_type_desc
e.g. Front Wheel Drive
Auto Trader's drivetrain description
drive_type_desc
e.g. 4X2
Number of wheels the engine is delivering power to.
number_seats
e.g. 4
Number of seats.
number_doors
e.g. 2
Number of doors.
number_gears
e.g. 6
Number of gears.
number_axles
e.g. 2
Number of axles.
derivative_desc
e.g. 1.5 Cooper Convertible (s/s) 2dr
Derivative description.
long_derivative_desc
e.g. 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)
An expanded version of the derivative description
introduced_date
e.g. 2020-01-01
The date the vehicle was available in the market from
discontinued_date
e.g. 2020-01-01
The date the vehicle was available to in the market
insurance_group_1to50
e.g. 22
The 1-50 insurance group
insurance_security_code
e.g. E
The Insurance group rating
top_speed_mph
e.g. 123
Manufacturer's claimed top speed in miles per hour
0to60_mph
e.g. 12.3
Manufacturer's claimed time (in seconds) for 0 - 60 miles per hour.
0to100_kmph
e.g. 12.3
Manufacturer's claimed time (in seconds) for 0 - 100 kilometers per hour.
vehicle_length_mm
e.g. 1234
Overall length of the vehicle (bumper to bumper). Does not include any after market items, which may extended the length of the vehicle in millimetres.
vehicle_height_mm
e.g. 1234
Overall height of the vehicle, including roof-bars or aerial in millimetres.
vehicle_width_mm
e.g. 1234
Overall width, including the wing mirrors in millimetres.
vehicle_wheelbase_mm
e.g. 1234
Measurement between the centre of the wheels on either side of the vehicle in millimetres.
bootspace_seats_up_litres
e.g. 123
The bootspace with seats up in litres
bootspace_seats_down_litres
e.g. 123
The bootspace with seats down in litres
payload_length_mm
e.g. 1234
The payload length in mm
payload_width_mm
e.g. 1234
The payload width in mm
payload_height_mm
e.g. 1234
The payload height in mm
payload_weight_kg
e.g. 123
Difference between the Kerb Weight and the Gross Weight in kilograms.
payload_volume_cubicmetres
e.g. 123
The payload volume in cubic metres
min_kerbweight_kg
e.g. 1234
Weight of the vehicle, including a full tank of fuel and all standard equipment in kilograms.
gross_vehicleweight_kg
e.g. 1234
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
gross_trainweight_kg
e.g. 1234
Maximum weight a vehicle is allowed (including) a trailor in kilograms
engine_manufacturer
e.g. MINI
Manufacturer of the engine.
engine_badged_size_litres
e.g. 1.2
Engine badged size in litres.
engine_capacity_cc
e.g. 1234
Cubic capacity of the engine.
engine_bore_mm
e.g. 12
Diameter measurement of the cylinder in millimetres.
engine_stroke_mm
e.g. 12
A measure (in millimetres) of the engine's cycle during which the piston travels from top to bottom or vice versa.
fuel_delivery
e.g. Turbo Common Rail
Fuel delivery method.
fuel_capacity_litres
e.g. 12
Fuel capacity in litres.
number_cylinders
e.g. 3
Number of cylinders within the engine.
cylinder_arrangement
e.g. Inline
Arrangement of the cylinders within the engine.
valve_gear
e.g. Double Overhead Camshaft
Describes the type/placement.
valves
e.g. 12
The number of valves
power_ps
e.g. 123
Power PS.
power_bhp
e.g. 123.5
Maximum BHP (Brake Horse Power) of this vehicle.
torque_nm
e.g. 123
Maximum power described in Torque Nm (Torque Newton Metres).
torque_lbft
e.g. 123.45
Maximum power described in Lb/ft (Pound per foot).
emission_class
e.g. Euro 6
European emission standard. Value indicates the emission levels in line with the age of the vehicle.
is_rde_compliant
e.g. true
Is the vehicle rde compliant
co2_gkm
e.g. 123
CO2 in g/km
is_startstop
e.g. true
Does the vehicle have start stop technology
nedc_extra_urban_mpg
e.g. 12.3
NEDC number of miles per gallon B-road, A-road and motorway driving ICE
nedc_urban_mpg
e.g. 12.3
The NEDC number of miles per gallon city driving ICE and SCH
nedc_combined_mpg
e.g. 12.3
The NEDC Average miles per gallon between urban (city driving) and extra urban (B-road, A-road and motorway) driving ICE and SCH
wltp_low_mpg
e.g. 12.3
The WLTP number of miles per gallon tested under wltp at speeds up to 35mph
wltp_medium_mpg
e.g. 12.3
The WLTP number of miles per gallon tested under wltp at speeds up to 47mph
wltp_high_mpg
e.g. 12.3
The WLTP number of miles per gallon tested under wltp at speeds up to 60mph
wltp_extra_high_mpg
e.g. 12.3
The WLTP number of miles per gallon tested under wltp at speeds up to 81mph
wltp_combined_mpg
e.g. 12.3
The WLTP average number of miles per gallon tested under wltp (low, medium, high & extra high)
oem_manufacturer_desc
e.g. MINI
The manufacturer description as supplied by manufacturer
oem_model_range_desc
e.g. Convertible
The model range description as supplied by manufacturer
oem_derivative_desc
e.g. Cooper Convertible
The derivative description as supplied by manufacturer
oem_body_type_desc
e.g. Convertible
The body type description as supplied by manufacturer
oem_transmission_type_desc
e.g. Manual
The transmission type description as supplied by manufacturer
oem_drivetrain_desc
e.g. Front wheel drive
The drivetrain description as supplied by manufacturer
oem_wheelbase_type_desc
e.g. STD
The wheelbase description as supplied by the manufacturer
oem_roof_height_type_desc
e.g. Low
The roof height description as supplied by the manufacturer
oem_engine_type_desc
e.g. DIG-T
The engine type description as supplied by manufacturer.
oem_engine_tech_desc
e.g. TBC
The engine technical description as supplied by manufacturer
oem_engine_desc
e.g. 58kWh
The engine description as supplied by manufacturer
oem_edition_desc
e.g. TBC
The edition description as supplied by manufacturer
oem_colour
e.g. Midnight Black
The exterior colour as supplied by manufacturer
feature_desc
e.g. 12Volt Socket in Front Centre Console
The feature description
feature_status
e.g. Standard
The feature status (default options priced at '£0' & can be swapped for alternative option)
feature_category
e.g. Audio and Communications
The feature category
list_price_ex_vat
e.g. 123.45
The list price excluding VAT
list_price_vat
e.g. 12.34
The list price VAT
list_price_inc_vat
e.g. 123.45
The list price including VAT
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call
Status Codes
200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com
Also Available From Auto Trader
Data Providers:
Auto TraderAutoPredictBregoCarketaCartellCazanaClearWattEV DatabaseEVOX ImagesExperianEzyvinMarketcheckPlate2VinRecall HQSagacitySalvageGuideSolifi Vehicle DataVIN AuditVehicle Data GlobalVehicle ImageryCategories:
Car ImagesCar Mileage ChecksCar SpecificationElectric Vehicle DataLicense Plate to VINOE VIN LookupRegistration (VRM) LookupSMR DataService HistoryVIN DecoderVehicle Build SheetVehicle DataVehicle History ChecksVehicle Recall ChecksVehicle Technical DataVehicle ValuationsSolutions:
Aftermarket & PartsAuction & RemarketingAutomotive Data ReportsCar Buying PlatformsConsultancy ServicesConsumer Websites & AppsData CleansingData ProvidersFinance BrokersFleet OperatorsFranchised DealersIndependent DealersLead ManagementLeasing & Fleet ManagementLeasing BrokersManufacturersMotor FinanceMotor InsuranceRetail Pricing StrategiesScrap & SalvageSoftware DevelopersVehicle Appraisal SoftwareVehicle AssessorsVehicle History ReportsWhole Life Costs