VRM Search
Find vehicle information from a vehicle registration mark.
Overview
The Vehicle Registration API allows you to search for a vehicle by supplying its number plate. The request requires a region, the state (dependent on the region), the number plate, and the API key. It will return either a matching vehicle or a null.
If a matching vehicle cannot be identified in all cases, we will return the upstream_vehicle
field, allowing you to identify how the relevant road transport authority describes the car. Depending on your use case, you may wish to allow front-end users to manually classify the vehicle using the guide to fill out a Facet-style search.
Get a vehicle by its registration number
Plate number of the registered vehicle
State is used in the AU region to narrow down a numberplate
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.
Comma separated list of additional registration lookup data codes, if using (e.g. additional_upstream_data)
The region to perform this request in
An optional reference id which will be stored against usage records if supplied
GET /v2/vehicles/registrations/{plate_number} 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"
}
}
}
}
Features
You can request more data than the standard payload by leveraging the features described below.
Additional Upstream
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
"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"
Last updated
Was this helpful?