VIN Search
Get vehicle details from a VIN.
Last updated
Was this helpful?
🇬🇧 UK AutoGrab API Doc
Get vehicle details from a VIN.
Last updated
Was this helpful?
The Vehicle VIN API allows you to search for vehicles by VIN. The request requires only a region, VIN, and API key. It will either return a matching vehicle with possible option packs or a null.
{
"success": true,
"vehicle": {
"id": "1122175340772663",
"region": "uk",
"title": "2019 Jeep Renegade Limited MY19 1.6 120hp E6d MT FWD LIMITED",
"year": "2019",
"make": "Jeep",
"model": "Renegade",
"badge": "Limited",
"series": null,
"model_year": "MY19",
"release_month": null,
"release_year": 2019,
"body_type": "SUV",
"body_config": null,
"transmission": "Manual",
"transmission_type": "Manual",
"wheelbase": null,
"wheelbase_type": null,
"fuel": "Diesel",
"fuel_type": "Diesel",
"engine": "Piston",
"engine_type": "Piston",
"drive": "FWD",
"drive_type": "Front Wheel Drive",
"num_doors": 5,
"num_seats": 5,
"num_gears": 6,
"num_cylinders": 4,
"capacity_cc": 1598,
"power_kw": 88,
"torque_nm": null,
"range": null,
"options": []
},
"upstream_vehicle": "2019 Jeep Renegade Limited Edition MultiJet II BU Diesel 5 dr 5 seat 4 cyl 6 speed SUV Manual 1598cc 88.4kw",
"confidence": "standard",
"additional_vehicles": []
}You can request more data than the standard payload by leveraging the features described below.
Ensure your commercial agreement has these features enabled if you require them.
This feature will return structured descriptive data from the registration authority. Use features=additional_upstream_data to receive this payload.
"additional_upstream_data": {
"vehicle_details": {
"vehicle_identification": {
"ukvd_id": "V-JZTYRS",
"ukvd_uvc": "M-NPGXL",
"vehicle_registration_mark": "KW73NKE",
"vehicle_identification_number": "W1K5J5BB4PN369431",
"dvla_manufacturer_desc": "MERCEDES-BENZ",
"dvla_model_desc": "AMG CLA 35 PREMIUM 4MATIC AUTO",
"dvla_wheelplan": "2 AXLE RIGID BODY",
"registration_date": "2023-11-20",
"first_registration_date": "2023-11-20",
"used_before_first_registration": false,
"manufactured_year": 2023,
"v5c_qty": 2,
"date_v5c_issued": "2023-11-20",
"engine_number": "26092030493649",
"prior_ni_vrm": "",
"dvla_body_desc": "COUPE",
"dvla_fuel_desc": "PETROL"
},
"vehicle_status_details": {
"is_non_eu_import": false,
"is_imported": false,
"certificate_of_destruction_issued": false,
"is_exported": false,
"exported_date": null,
"is_scrapped": false,
"scrapped_date": null
},
"vehicle_excise_duty_details": {
"co2_gkm": 191,
"dvla_co2_band": null,
"12_month_rfl_y1": 1650,
"6_month_rfl_y2_to_y6_premium": 330,
"12_month_rfl_y2_to_y6_premium": 600,
"6_month_rfl_y2_to_y6": 104.5,
"12_month_rfl_y2_to_y6": 190
},
"colour_details": {
"colour": "WHITE",
"colour_changes_qty": 0,
"original_colour": "WHITE",
"last_colour": null,
"date_of_last_colour_change": null
},
"keeper_change_list": [
{
"number_previous_keepers": 1,
"date_of_last_keeper_change": "2024-06-08"
}
],
"plate_change_list": []
},
"model_details": {
"ukvd_variant_code": 1,
"model_data": {
"manufacturer_desc": "Mercedes-AMG",
"model_range_desc": "CLA",
"model_desc": "AMG CLA 35 Premium 4Matic Auto",
"model_variant": null,
"ukvd_series_desc": "C118",
"ukvd_mark": null,
"model_start_date": "2022-07-22",
"model_end_date": null,
"emission_class": "6d",
"country_of_origin": "Germany",
"ukvd_fuel_type_desc": "Petrol",
"cab_type_desc": null,
"type_approval_category": "M1",
"market_sector_code": null,
"vehicle_type": "Car",
"vehicle_taxation_class": "Car"
},
"body_details": {
"ukvd_body_shape": null,
"ukvd_body_type_desc": "Coupe",
"fuel_capacity_litres": 51,
"number_axles": 2,
"number_doors": 4,
"number_seats": 5,
"payload_volume_square_metres": null,
"wheelbase_type_desc": "Short Wheelbase",
"platform_desc": null,
"is_platform_shared": null
},
"dimensions": {
"vehicle_height_mm": 1404,
"vehicle_length_mm": 4695,
"vehicle_width_mm": 1834,
"vehicle_wheelbase_mm": null,
"load_length_mm": null
},
"weights": {
"min_kerbweight_kg": 1615,
"gross_trainweight_kg": null,
"unladen_weight_kg": null,
"payload_weight_kg": null,
"gross_vehicleweight_kg": 2115,
"gross_combined_weight_kg": 2115
},
"power_source": {
"power_source_vehicle_type": "ICE",
"ice_details": {
"engine_family": null,
"engine_stroke_mm": 92,
"valves_per_cylinder": 4,
"aspiration": "Turbocharged",
"number_cylinders": 4,
"engine_location": "Front",
"cylinder_arrangement": "Inline",
"valve_gear": "DOHC",
"ukvd_engine_desc": "M260 E20DEH LA G AMG",
"engine_bore_mm": 83,
"engine_manufacturer": "Mercedes Cars",
"fuel_delivery": null,
"power_delivery": "Normal",
"engine_capacity_cc": 1991,
"engine_badged_size_litres": 2
},
"electric_details": null
},
"euro_ncap": {
"ncap_overall_rating": 5,
"ncap_child_occupant_protection_percentage": 91,
"ncap_adult_occupant_protection_percentage": 96,
"ncap_pedestrian_protection_percentage": 91,
"ncap_safety_assist_percentage": 75
},
"emissions": {
"is_fuel_catalyst": true,
"co2_gkm": null
},
"performance": {
"torque": {
"torque_nm": 400,
"torque_lbft": 295.2,
"torque_rpm": 4000,
"torque_derived_from": null
},
"power": {
"power_bhp": 301.7,
"power_ps": 305.9,
"kilowatt": 225,
"power_rpm": 5800
},
"statistics": {
"0to60_mph": null,
"0to100_kmph": null,
"max_speed_kmh": 250,
"top_speed_mph": 155
}
},
"fuel_economy": {
"nedc_extra_urban_litres_100km": null,
"nedc_extra_urban_mpg": null,
"nedc_extra_urban_cold_litres_100km": null,
"nedc_extra_urban_cold_mpg": null,
"combined_litres_100km": 8.4,
"combined_mpg": 33.6
},
"sound_levels": {
"stationary_soundlevel_db": null,
"stationary_soundlevel_rpm": null,
"driveby_soundlevel_db": null
},
"transmission": {
"driving_axle": "All Permanent",
"number_gears": 7,
"transmission_type": "Automatic",
"drive_type_desc": "4x4"
}
}
},"build_data": {
"vin": "WAUZZZ8V7K1028938",
"make": "AUDI",
"model": "A3",
"features": [
{
"code": "0A1",
"value": "2 doors"
},
{
"code": "0AE",
"value": "Front stabilizer bar"
},
{
"code": "0B2",
"value": "Wheelbase"
},
],
"build_date": "2019-03-20"Get a vehicle by its VIN
Plate number of the registered vehicle
Comma separated list of additional registration lookup data codes, if using (e.g. additional_upstream_data)
If enabled, a larger selection of vehicles may be returned and a manual selection would be required to select the correct vehicle. This is disabled by default in favor of a system which will infer the correct vehicle and order the results by likelihood of behind correct.
The region to perform this request in
An optional reference id which will be stored against usage records if supplied
GET /v2/vehicles/vins/{vin} HTTP/1.1
Host: api.autograb.com.au
ApiKey: YOUR_API_KEY
Accept: */*
{
"success": true,
"vehicle": {
"id": "text",
"region": "au",
"title": "text",
"year": 1,
"make": "text",
"model": "text",
"badge": "text",
"series": "text",
"body_type": "text",
"body_config": "text",
"transmission": "text",
"wheelbase": "text",
"fuel": "text",
"engine": "text",
"drive": "text",
"num_doors": 1
},
"upstream_vehicle": "text",
"confidence": "standard",
"colour": "text",
"vin": "text",
"additional_vehicles": [
{
"id": "text",
"region": "au",
"title": "text",
"year": 1,
"make": "text",
"model": "text",
"badge": "text",
"series": "text",
"body_type": "text",
"body_config": "text",
"transmission": "text",
"wheelbase": "text",
"fuel": "text",
"engine": "text",
"drive": "text",
"num_doors": 1
}
],
"extended_data": null,
"registration_status": {
"expiry_date": "text",
"status": "text"
},
"vehicle_age": {
"compliance_plate": "text",
"year_of_manufacture": 1
},
"writeoff_info": {},
"build_data": {
"vin": "text",
"build_date": "text",
"make": "text",
"model": "text",
"features": [
{
"code": "text",
"value": "text"
}
]
},
"odo_history": [
{
"read_date": "text",
"odometer": 1
}
],
"odo_prediction": {
"prediction": 1,
"days_since_read": 1,
"avg_yearly": 1,
"avg_daily": 1,
"ag_market_avg": 1
},
"vsrr": {
"fuel_economy": {
"star_rating": 1,
"consumption": 1
},
"emissions": {
"co2": 1,
"star_rating": 1
},
"pollutants": {
"star_rating": 1,
"test_regime": "text"
},
"safety": {
"driver": {
"star_rating": 1,
"test_regime": "text"
}
}
}
}