Retail Pricing, Market Metrics & Vehicle Data
Auto Trader provides vehicle data that helps UK automotive businesses identify stock, understand its specification and make informed pricing decisions. Its valuation and retail metrics services support decisions throughout a vehicle’s journey, from acquisition and part-exchange to advertising and sale.
One Auto API is an Auto Trader Connect partner, providing licensed users with access to Auto Trader vehicle identification, specification, valuation and retail metrics data. Through our single API platform, businesses can bring that information into their existing systems and combine it with services from other vehicle data providers.
Autotrader API integration can begin with vehicle identification. Using a registration number, an application can retrieve vehicle details include the correct model and derivative. Specification data can then support appraisal, stock creation and accurate vehicle descriptions, reducing the need to enter the same information across multiple systems.
Auto Trader valuations add a view of vehicle value for different selling contexts, including retail, trade, private sale and part-exchange. Retail metrics provide further insight into market conditions. Depending on the service and licence available, these can include supply, demand, Retail Rating and estimated days to sell. Together, valuations and metrics help businesses consider both a vehicle’s potential selling price and how well it may perform in the market.
Stock management: Identify vehicles, retrieve specification details and populate stock records with consistent information. Data can flow into dealer management systems, websites and other applications used to prepare vehicles for sale. Adding valuation and retail metrics information gives stock teams more context when reviewing the forecourt.
Retail pricing: Use valuation data as a starting point for setting or reviewing an advertised price. Retail metrics can help teams assess demand and expected speed of sale, supporting decisions about when to adjust a price. This is useful for businesses that need to balance margin with stock turn across many vehicles.
Part-exchanges: Build appraisal journeys that begin with a registration lookup and return the correct vehicle details. A part-exchange valuation can inform the initial assessment, while specification and market information give the team a fuller picture before making an offer. The resulting workflow can support both online enquiries and conversations in the showroom.
Stock buying: Evaluate vehicles before committing to an acquisition. Combining identification, valuation and retail metrics helps buying teams compare opportunities, consider likely retail performance and decide which vehicles suit their business. The same data can support buying from consumers, trade sources or auctions.
Market intelligence: Monitor the conditions affecting pricing and demand for different vehicles. Supply, demand, Retail Rating and days-to-sell estimates can help teams review their stock mix and understand how particular vehicles may perform. Making these insights available within existing tools helps decision-makers act on the data during their normal workflow.
One Auto API gives licensed users a route to Auto Trader data alongside access to other automotive data providers through a single API. A business might use Auto Trader valuations and retail metrics for pricing, then add a vehicle history check or another specialist dataset to support a wider appraisal or stock buying process. This approach allows teams to build the workflow they need without maintaining a separate technical integration for every source.
Access to Auto Trader data is subject to the relevant licence and permitted use. We can help you identify which services fit your application and how they should be incorporated into it. That matters whether you are extending a dealership’s existing tools or building a product for multiple licensed users.
If you are searching for an Auto Trader API integration partner in the UK, our team can help scope the vehicle data, valuation and metrics endpoints needed for your UK workflow. For developers looking for Auto Trader API documentation, One Auto API provides technical resources and a sandbox to help plan and test the integration. We can discuss the applicable licensing arrangements, the services required and your expected usage before recommending an approach.
Whether your priority is faster stock creation, more informed retail pricing or a better part-exchange journey, One Auto API can help you put Auto Trader data to work within the systems your business already uses.
| Field Name | Field Type | Example | Definition |
|---|---|---|---|
| 0to100_ | Float | 12.3 | Manufacturer's claimed time (in seconds) for 0 - 100 kilometers per hour. |
| 0to60_ | Float | 12.3 | Manufacturer's claimed time (in seconds) for 0 - 60 miles per hour. |
| advertised_ | Int | The advertised price of the vehicle | |
| asset_ | String | car | The asset type. |
| autotrader_ | String | Car | Auto Trader's asset type |
| autotrader_ | String | Convertible | Auto Trader's body type description |
| autotrader_ | String | 1a2b345cf6d789ef1g0111h2i13j141k | The Auto Trader Derivative ID |
| autotrader_ | String | Front Wheel Drive | Auto Trader's drivetrain description |
| autotrader_ | String | Petrol | Auto Trader's fuel type |
| autotrader_ | String | 1a2b345cf6d789ef1g0111h2i13j141k | The Auto Trader identifier for that generation of vehicle |
| autotrader_ | String | 1a2b345cf6d789ef1g0111h2i13j141k | The Auto Trader identifier for the vehicle manufacturer |
| autotrader_ | String | 1a2b345cf6d789ef1g0111h2i13j141k | Auto Trader identifier for the vehicle model range |
| autotrader_ | String | Manual | Auto Trader's transmission description |
| bootspace_ | Int | 123 | The bootspace with seats down in litres |
| bootspace_ | Int | 123 | The bootspace with seats up in litres |
| cab_ | String | Crew cab | Cab type (applicable to commercial vehicles). |
| charge_ | String | Type 2 | Type of port for this charge port item. |
| charger_ | Int | 2580 | Onboard charger chargetime 1 to 100% in minutes. |
| co2_ | Int | 123 | CO2 in g/km |
| colour | String | RED | Exterior colour of vehicle. |
| country_ | String | United Kingdom | Where the vehicle was made and manufactured. |
| current_ | Int | 12345 | Current mileage of the vehicle |
| current_ | Boolean | When supplying a "true" value will return only generations currently in production | |
| cylinder_ | String | Inline | Arrangement of the cylinders within the engine. |
| date_ | Date | 2022-01-01 | Date of last keeper change. |
| days_ | Float | 123 | The expected number of days it will take to sell the vehicle. |
| delivery_ | Int | 595 | Delivery price excluding VAT |
| delivery_ | Float | 1234.56 | The delivery price VAT |
| derivative_ | String | Long Range Single Motor | EV Database’s model variant. |
| discontinued_ | String | null | The date the vehicle was available to in the market |
| drive_ | String | 4X2 | Number of wheels the engine is delivering power to. |
| effective_ | Date | Return the pricing relevant to the chosen vehicle for that moment in time. | |
| effective_ | Date | 2020-01-01 | The date the price is effective from |
| effective_ | Date | 2020-01-01 | The date the price is effective to |
| electric_ | String | 230V10A1X | Electric vehicle supply equipment description. |
| electric_ | Float | 2.3 | Rate of the power delivery in kilowatts. |
| emission_ | String | Euro 6 | European emission standard. Value indicates the emission levels in line with the age of the vehicle. |
| engine_ | Float | 1.5 | Engine badged size in litres. |
| engine_ | Int | 82 | Diameter measurement of the cylinder in millimetres. |
| engine_ | Int | 1499 | Cubic capacity of the engine. |
| engine_ | String | 1197cc, 69 HP, 75 | Engine data |
| engine_ | String | Mini | Manufacturer of the engine. |
| engine_ | String | A12345678 | Vehicle engine number. |
| engine_ | Int | 95 | A measure (in millimetres) of the engine's cycle during which the piston travels from top to bottom or vice versa. |
| error | String | Example error details | Details of what went wrong with the api call |
| fast_ | Int | 40 | 10-80% fast charger charge time in minutes |
| feature_ | String | Audio and Communications | The feature category |
| feature_ | String | 12Volt Socket in Front Centre Console | The feature description |
| feature_ | String | 12V Socket | The feature generic description |
| feature_ | String | Standard | The feature status (default options priced at '£0' & can be swapped for alternative option) |
| first_ | Date | 2020-01-01 | Date of first registration. |
| forecast_ | Date | This is the date when the forecasted value is required. | |
| forecast_ | Int | 12345 | The suggested future market average retail valuation for the specified vehicle |
| forecast_ | Int | 12345 | The suggested future market average trade valuation for the specified vehicle |
| fuel_ | Int | 40 | Fuel capacity in litres. |
| fuel_ | String | Injection | Fuel delivery method. |
| future_ | Int | he mileage the vehicle will complete by the forecast date | |
| generation_ | String | Hatchback (2018 - 2021) | The generation description |
| gross_ | Int | 1234 | Maximum weight a vehicle is allowed (including) a trailor in kilograms |
| gross_ | Int | 2359 | Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms. |
| insurance_ | String | 22 | The 1-50 insurance group |
| insurance_ | String | E | The Insurance group rating |
| introduced_ | String | 2024-01-01 | The date the vehicle was available in the market from |
| is_ | Boolean | true | Vehicle is exported. |
| is_ | Boolean | Is the feature factory fitted | |
| is_ | Boolean | true | Vehicle is imported. |
| is_ | Boolean | true | Is the vehicle rde compliant |
| is_ | Boolean | true | Has the vehicle been scrapped. |
| is_ | Boolean | true | Does the vehicle have start stop technology |
| is_ | Boolean | true | Is the vehicle stolen |
| list_ | Float | 123.45 | The list price excluding VAT |
| list_ | Float | 12345.67 | The list price + delivery price including VAT |
| list_ | Float | 123.45 | The list price including VAT |
| list_ | Float | 12.34 | The list price VAT |
| location_ | Float | 12.34 | Modelled metric of the potential retail performance of a vehicle based on the Days to Sell, Supply and Demand for the given location (1-100) (1: poor performance, 100: good performance). |
| long_ | String | 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps) | An expanded version of the derivative description |
| manufacturer_ | String | Mini | Manufacturer description |
| market_ | Float | 0.12 | Modelled number to illustrate current market condition based on Supply & Demand metrics (-0-1+) (-0: poor market condition, 1+: average-good market condition). |
| market_ | Float | 1.23 | A comparison of the national demand observed on Auto Trader over the last 7 days relative to the level of demand that has been observed over the last 6 months (-0 to 1+) (-0: low demand, 1+: average-high demand). |
| market_ | Float | 1.2 | A comparison of the national market supply observed on Auto Trader over the last 7 days relative to the market supply that has been observed over the last 6 months (-0 to 1+) (-0: high supply, 1+: average-limited supply). |
| maximum_ | Int | 2085 | Maximum permissable mass in kilograms. |
| miles_ | Int | The expected annual mileage | |
| min_ | Int | 1135 | Weight of the vehicle, including a full tank of fuel and all standard equipment in kilograms. |
| model_ | String | Hatch | Model range description. |
| national_ | Float | 12.3 | The expected number of days it will take to sell the vehicle based on the chosen advertised price at national level. |
| national_ | Float | 12.3 | The modelled metric of the potential retail performance of a vehicle based on the Days to Sell, Supply and Demand at national level. |
| nedc_ | Float | 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 |
| nedc_ | Float | 61.4 | NEDC number of miles per gallon B-road, A-road and motorway driving ICE |
| nedc_ | Float | 12.3 | The NEDC number of miles per gallon city driving ICE and SCH |
| number_ | Int | 2 | Number of axles. |
| number_ | Int | 3 | Number of cylinders within the engine. |
| number_ | Int | 2 | Number of doors. |
| number_ | Int | 1 | Number of gears. |
| number_ | Int | 1 | Number of previous keepers. |
| number_ | Int | 5 | Number of seats. |
| oem_ | String | Convertible | The body type description as supplied by manufacturer |
| oem_ | String | Midnight Black | The exterior colour as supplied by manufacturer |
| oem_ | String | Cooper Convertible | The derivative description as supplied by manufacturer |
| oem_ | String | Front wheel drive | The drivetrain description as supplied by manufacturer |
| oem_ | String | TBC | The edition description as supplied by manufacturer |
| oem_ | String | 58kWh | The engine description as supplied by manufacturer |
| oem_ | String | TBC | The engine technical description as supplied by manufacturer |
| oem_ | String | DIG-T | The engine type description as supplied by manufacturer. |
| oem_ | String | MINI | The manufacturer description as supplied by manufacturer |
| oem_ | String | Convertible | The model range description as supplied by manufacturer |
| oem_ | String | Low | The roof height description as supplied by the manufacturer |
| oem_ | String | Manual | The transmission type description as supplied by manufacturer |
| oem_ | String | STD | The wheelbase description as supplied by the manufacturer |
| part_ | Int | 12345 | The suggested market average part exchange valuation for the specified vehicle (location, market and condition adjusted). |
| payload_ | Int | 1234 | The payload height in mm |
| payload_ | Int | 1234 | The payload length in mm |
| payload_ | Int | 123 | The payload volume in cubic metres |
| payload_ | Int | 123 | Difference between the Kerb Weight and the Gross Weight in kilograms. |
| payload_ | Int | 1234 | The payload width in mm |
| post_ | String | AB1 2CD | The location of the stock vehicle used as the centre of the search. |
| power_ | Float | 201.2 | Maximum BHP (Brake Horse Power) of this vehicle. |
| power_ | Int | 204 | Power PS. |
| previous_ | Date | 2020-01-01 | The previous keepers acquisition date |
| private_ | Int | 12345 | The suggested market average private sale valuation for the specified vehicle (location, market and condition adjusted). |
| result | String | fail | Has the vehicle passed all lead validation tests. |
| retail_ | Int | 12345 | The suggested market average retail valuation for the specified vehicle (cars only). |
| retail_ | Int | 12345 | The suggested market average retail valuation excluding vat for the specified vehicle (cars only). |
| roof_ | String | Low | The roof height description |
| style | String | tractor | The style of vehicle |
| substyle | String | large tractor | The substyle of vehicle |
| success | Boolean | true | Whether the api call was successful |
| top_ | Int | 103 | Manufacturer's claimed top speed in miles per hour |
| torque_ | Float | 291.5 | Maximum power described in Lb/ft (Pound per foot). |
| torque_ | Int | 395 | Maximum power described in Torque Nm (Torque Newton Metres). |
| trade_ | Int | 12345 | The suggested market average trade valuation for the specified vehicle (location, market and condition adjusted). |
| trim_ | String | Cooper | The trim level description |
| valve_ | String | Double Overhead Camshaft | Describes the type/placement. |
| valves | Int | 12 | The number of valves |
| vehicle_ | Int | Vehicle's condition (0-100 - where 0 is very poor and 100 is retail-ready) | |
| vehicle_ | String | Mini Cooper S | The Vehicle description |
| vehicle_ | Int | 1414 | Overall height of the vehicle, including roof-bars or aerial in millimetres. |
| vehicle_ | String | ABCDE123456F78910 | Vehicle identification number (VIN). |
| vehicle_ | Int | 3821 | 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_ | String | Vehicle registration number (VRM). | |
| vehicle_ | String | Supermini Conv | The vehicle sector as defined by Auto Trader |
| vehicle_ | Int | 2495 | Measurement between the centre of the wheels on either side of the vehicle in millimetres. |
| vehicle_ | Int | 1727 | Overall width, including the wing mirrors in millimetres. |
| wheelbase_ | String | Short Wheelbase | Wheelbase type. |
| wltp_ | Float | 12.3 | The WLTP average number of miles per gallon tested under wltp (low, medium, high & extra high) |
| wltp_ | Float | 12.3 | The WLTP number of miles per gallon tested under wltp at speeds up to 81mph |
| wltp_ | Float | 12.3 | The WLTP number of miles per gallon tested under wltp at speeds up to 60mph |
| wltp_ | Float | 12.3 | The WLTP number of miles per gallon tested under wltp at speeds up to 35mph |
| wltp_ | Float | 12.3 | The WLTP number of miles per gallon tested under wltp at speeds up to 47mph |
{
"success": true,
"result": {
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"retail_valuation": 12345,
"retail_valuation_ex_vat": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"derivatives_data": [
{
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"derivative_desc": "1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)"
}
]
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"forecast_retail_valuation": 12345,
"forecast_trade_valuation": 12345,
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k"
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"vehicle_registration_mark": "AB21ABC",
"first_registration_date": "2020-01-01",
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"forecast_retail_valuation": 12345,
"forecast_trade_valuation": 12345
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"generations_data": [
{
"autotrader_generation_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"generation_desc": "Convertible (2019- 2022)"
}
]
},
"error": "If there is an error the message would go here"
}{
"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"
}{
"success": true,
"result": {
"manufacturers_data": [
{
"manufacturer_desc": "BMW",
"autotrader_manufacturer_id": "1a2b345cf6d789ef1g0111h2i13j141k"
}
]
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"modelranges_data": [
{
"model_range_desc": "Hatch",
"autotrader_model_id": "1a2b345cf6d789ef1g0111h2i13j141k"
}
]
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"prices_data": [
{
"effective_from_date": "2020-01-01",
"effective_to_date": "2020-01-01",
"list_price_ex_vat": 12345.67,
"list_price_vat": 1234.56,
"delivery_price_ex_vat": 12345.67,
"delivery_price_vat": 1234.56,
"list_price_inc_delivery_vat": 12345.67
}
],
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k"
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"retail_valuation": 12345,
"retail_valuation_ex_vat": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345,
"national_market_rating": 12.3,
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k"
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"vehicle_registration_mark": "AB21ABC",
"first_registration_date": "2020-01-01",
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"retail_valuation": 12345,
"retail_valuation_ex_vat": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345,
"national_market_rating": 12.3
},
"error": "If there is an error the message would go here"
}{
"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"
}{
"success": true,
"result": {
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"retail_valuation": 12345,
"retail_valuation_ex_vat": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345,
"market_supply": 1.2,
"market_demand": 1.23,
"market_condition": 0.12,
"locations": [
{
"location_market_rating": 12.34,
"days_to_sell": 123,
"post_code": "AB12ABC"
}
],
"national_market_rating": 12.3,
"national_days_to_sell": 12.3
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"vehicle_registration_mark": "AB21ABC",
"first_registration_date": "2020-01-01",
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"vehicle_desc": "MINI Convertible 1.5 Cooper Convertible 2dr Petrol Manual (s/s) (136 ps)",
"retail_valuation": 12345,
"retail_valuation_ex_vat": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345,
"market_supply": 1.2,
"market_demand": 1.23,
"market_condition": 0.12,
"locations": [
{
"location_market_rating": 12.34,
"days_to_sell": 123,
"post_code": "AB12ABC"
}
],
"national_market_rating": 12.3,
"national_days_to_sell": 12.3
},
"error": "If there is an error the message would go here"
}{
"success": true,
"result": {
"autotrader_derivative_id": "1a2b345cf6d789ef1g0111h2i13j141k",
"retail_valuation": 12345,
"private_valuation": 12345,
"trade_valuation": 12345,
"part_exchange_valuation": 12345,
"retail_valuation_ex_vat": 12345
},
"error": "If there is an error the message would go here"
}{
"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"
}We provide access to vehicle lookups; specifications; current and forecast valuations; retail rating and market metrics - alongside data from other leading providers in a single API. Your level of data access will be determined by your licence with Auto Trader.
Dealers advertising with Auto Trader may have data access as part of an advertising package; other businesses will be required to purchase an enterprise licence from Auto Trader.
Set up your One Auto API account as normal, then let us know your Dealer ID (DID) and we will contact Auto Trader to enable access.
Auto Trader Retail Check combines the Auto Trader Valuation and Retail Rating in a single data package. Retail Rating scores how well a vehicle should sell based on supply and demand and is used when appraising part-exchanges, buying stock or to help implement a retail pricing strategy.
Online appraisal and part-exchange tools, stock acquisition, inventory management, pricing engines, and dealer management system integrations can all be supported with real-time valuation and market metrics data - alongside other data sources.
We provide access to Auto Trader data via a single API, alongside other data providers - with simpler authentication and harmonised field names for faster integration.
We provide access to vehicle lookups; specifications; current and forecast valuations; retail rating and market metrics - alongside data from other leading providers in a single API. Your level of data access will be determined by your licence with Auto Trader.
Dealers advertising with Auto Trader may have data access as part of an advertising package; other businesses will be required to purchase an enterprise licence from Auto Trader.
Set up your One Auto API account as normal, then let us know your Dealer ID (DID) and we will contact Auto Trader to enable access.
Auto Trader Retail Check combines the Auto Trader Valuation and Retail Rating in a single data package. Retail Rating scores how well a vehicle should sell based on supply and demand and is used when appraising part-exchanges, buying stock or to help implement a retail pricing strategy.
Online appraisal and part-exchange tools, stock acquisition, inventory management, pricing engines, and dealer management system integrations can all be supported with real-time valuation and market metrics data - alongside other data sources.
We provide access to Auto Trader data via a single API, alongside other data providers - with simpler authentication and harmonised field names for faster integration.
Get instant access to our sandbox API and start building today.
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