UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Inventory Augmentation

Powered by Auto Trader

Auto Trader is the largest vehicle marketplace in the UK, powered by comprehensive data on technical, standard and optional features linked to vehicle registration mark (VRM).

 

The service includes an Auto Trader Vehicle Lookup and returns the standard and optional features available on the vehicle at the date of registration, giving you the option to enhance your inventory with factory fitted options. 

 

Key features:

 

  • Car and Van data from a single endpoint

  • Basic vehicle information (upto 28 fields)

  • Insurance data

  • Performance data

  • Weights, dimensions and capacities

  • Engine data

  • EV data

  • OEM data

  • Standard Features

  • Optional Features

  • Includes a basic vehicle check

  • From 1p per lookup

Pricing

PAYG
3p
Per Use
Business
2p
Per Use
Enterprise
1p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)3p4c5c
Business (Per Use)2p3c3c
Enterprise (Per Use)1p2c2c

Documentation

Introduction

In addition to Auto Trader's Vehicle Lookup service this endpoint also returns standard and optional features available on the vehicle at the date of registration.

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/inventoryaugmentationfromvrm?vehicle_registration_mark=AB21ABC

Example Sandbox Request

https://sandbox.oneautoapi.com/autotrader/inventoryaugmentationfromvrm?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"
    },
    "features_data": [
      {
        "feature_desc": "12Volt Socket in Front Centre Console",
        "feature_generic_desc": "12V Socket",
        "feature_status": "Optional",
        "is_factory_fitted": false,
        "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
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
feature_desc
e.g. 12Volt Socket in Front Centre Console
The feature description
feature_generic_desc
e.g. 12V Socket
The feature generic description
feature_status
e.g. Optional
The feature status (default options priced at '£0' & can be swapped for alternative option)
is_factory_fitted
e.g. false
Is the feature factory fitted
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

Accelerator
Auto Trader Valuation from VRM

Accurate vehicle values powered by millions of vehicles from a VRM. 100% data-driven pricing that reflects the current market.

Accelerator
Derivatives

Taxonomy endpoint providing a list of derivatives for a specified model range generation.

Accelerator
Future Values from ID

Forecast values for new and used cars, from a stored ID or manual vehicle selection. Fully-adjustable to a maximum vehicle age of 10 years.

Accelerator
Future Values from VRM

Forecast values for cars registered in the UK. Fully-adjustable for any term, mileage and forecast date to a maximum vehicle age of 10 years.

Accelerator
Generations

Taxonomy endpoint providing a list of generations for a specified model range.