AutoTrader is the largest vehicle marketplace in the UK, powered by clear, consistent and comprehensive descriptive data linked to vehicle registration mark (VRM).
The service provides a comprehensive selection of data from a VRM and includes a basic vehicle check to tell you if the vehicle has been written off, stolen and the number of previous keepers.
Key features:
-
Car and Van lookup from a single endpoint
-
Basic vehicle information (up to 28 fields)
-
Insurance data
-
Performance data
-
Weights, dimensions and capacities
-
Engine data
-
EV data
-
OEM data
-
Includes a basic vehicle check
- From 1p per lookup
Sample Response
V2
Documentation
Introduction
This endpoint returns the basic vehicle information, insurance, performance, EV and OEM data. In addition, a basic vehicle check is returned along with weights dimensions and capacities.
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/vehiclelookupfromvrm?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/autotrader/vehiclelookupfromvrm?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
Sample Response
{
"success": true,
"result": {
"basic_vehicle_info": {
"vehicle_registration_mark": "AB21ABC",
"vehicle_identification_number": "ABCDE123456F78910",
"first_registration_date": "2020-01-01",
"country_of_origin": "United Kingdom",
"colour": "Black",
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"autotrader_asset_type": "Car",
"vehicle_sector": "Supermini Conv",
"manufacturer_desc": "MINI",
"model_range_desc": "Convertible",
"generation_desc": "Convertible (2015 - 2018)",
"derivative_desc": "1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"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,
"style": "tractor",
"substyle": "large tractor"
},
"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,
"maximum_permissable_mass_kg": 1234,
"gross_trainweight_kg": 1234
},
"engine_data": {
"engine_manufacturer": "MINI",
"engine_number": "AB12345",
"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
},
"ev_data": {
"onboard_charger_table": [
{
"charger_chargetime_0to100_mins": 210,
"electric_vehicle_supply_equipment_power_kw": 22,
"electric_vehicle_supply_equipment_desc": "22kW AC Three Phase",
"charge_port_type": "Type 2"
}
],
"fast_charger_table": [
{
"fast_charger_chargetime_10to80_percent_mins": 40,
"electric_vehicle_supply_equipment_power_kw": 50,
"electric_vehicle_supply_equipment_desc": "50kW DC",
"charge_port_type": "CCS"
}
]
},
"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"
},
"basic_vehicle_check": {
"is_stolen": false,
"is_scrapped": false,
"is_exported": false,
"is_imported": false,
"number_previous_keepers": 1,
"date_of_last_keeper_change": "2020-01-01",
"previous_keeper_acquisition_date": "2020-01-01"
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_registration_mark
e.g. AB21ABC
Vehicle registration number (VRM).
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
first_registration_date
e.g. 2020-01-01
Date of first registration.
country_of_origin
e.g. United Kingdom
Where the vehicle was made and manufactured.
colour
e.g. Black
Exterior colour of vehicle.
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
derivative_desc
e.g. 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)
Derivative 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.
style
e.g. tractor
The style of vehicle
substyle
e.g. large tractor
The substyle of vehicle
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.
maximum_permissable_mass_kg
e.g. 1234
Maximum permissable mass 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_number
e.g. AB12345
Vehicle engine number.
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)
charger_chargetime_0to100_mins
e.g. 210
Onboard charger chargetime 1 to 100% in minutes.
electric_vehicle_supply_equipment_power_kw
e.g. 22
Rate of the power delivery in kilowatts.
electric_vehicle_supply_equipment_desc
e.g. 22kW AC Three Phase
Electric vehicle supply equipment description.
charge_port_type
e.g. Type 2
Type of port for this charge port item.
fast_charger_chargetime_10to80_percent_mins
e.g. 40
10-80% fast charger charge time in minutes
electric_vehicle_supply_equipment_power_kw
e.g. 50
Rate of the power delivery in kilowatts.
electric_vehicle_supply_equipment_desc
e.g. 50kW DC
Electric vehicle supply equipment description.
charge_port_type
e.g. CCS
Type of port for this charge port item.
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
is_stolen
e.g. false
Is the vehicle stolen
is_scrapped
e.g. false
Has the vehicle been scrapped.
is_exported
e.g. false
Vehicle is exported.
is_imported
e.g. false
Vehicle is imported.
number_previous_keepers
e.g. 1
Number of previous keepers.
date_of_last_keeper_change
e.g. 2020-01-01
Date of last keeper change.
previous_keeper_acquisition_date
e.g. 2020-01-01
The previous keepers acquisition date
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