Identifies the IDS Code for a car or light commercial vehicle, along with basic technical details and DVLA data including tax status.
IDS code can be used to retrieve data from other Solifi endpoints.
Key Features
VRM-based lookup
Easily identify vehicles based on a registration mark
Model Year Compliant
IDS Codes are model year compliant, for increased precision in vehicle data and pricing
Comprehensive
IDS Codes cover 200,000+ cars and commercials, providing access to highly accurate, up-to-date vehicle data
P11D Value
Includes the basic cost new for history P11D and vehicle tax purposes
DVLA Data
Includes VIN, registration date, enxgine number and import/export status
MOT & Tax Status
Identifies the current tax and MOT status of the vehicle, along with associated expiry data
Sample Response
V2
Documentation
Introduction
This endpoint returns Solifi's basic vehicle information including the IDS Code. In addition, it returns the DVLA data block, including number of doors, seats, fuel type, body type, CO2, registration dates, VIN and scrappage status.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/solifi/vehiclelookupfromvrm?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/solifi/vehiclelookupfromvrm?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
Sample Response
{
"success": true,
"result": {
"solifi": {
"ids_code": "AB001234",
"introduced_date": "2020-01-01",
"engine_capacity_cc": 1234,
"power_bhp": 123,
"ids_fuel_type": "Petrol",
"fuel_delivery": "Turbo",
"ids_transmission_type": "Manual",
"number_doors": 5,
"ids_body_type_desc": "Hatchback",
"engine_configuration_type": "4 Cylinder In-Line",
"ids_drivetrain_desc": "Front Wheel",
"ids_manufacturer_code": "NI",
"manufacturer_desc": "NISSAN",
"ids_model_code": "NIYF",
"ids_model_desc": "Old QASHQAI model range",
"derivative_desc": "QASHQAI HAT 1.6dCi ACENTA STOP/START",
"model_desc": "Qashqai",
"ids_model_tree_desc": "Old Qashqai",
"ids_derivative_tree_desc": "1.6dCi Acenta Stop/Start",
"oem_model_range_desc": "Qashqai Hatch",
"ids_model_year": "12",
"full_model_year": 2020.25,
"is_special_edition": false,
"state": "Old",
"is_commercial_vehicle": false,
"P11D_price": 12345,
"production_end_date": "2020-01-01"
},
"dvla": {
"vehicle_registration_mark": "AB21 ABC",
"dvla_body_desc": "5 DOOR HATCHBACK",
"co2_gkm": 123,
"colour": "RED",
"cherished_plate_on_vehicle": true,
"manufactured_date": "2020-01-01",
"first_registration_date": "2020-01-01",
"dvla_manufacturer_desc": "NISSAN",
"dvla_model_desc": "QASHQAI ACENTA IS DCI",
"engine_number": "A12345678",
"exported_date": "2020-01-01",
"is_exported": false,
"dvla_fuel_desc": "DIESEL",
"imported_date": "2020-01-01",
"is_imported": false,
"is_imported_NI": false,
"previous_keeper_acquisition_date": "2020-01-01",
"previous_keeper_disposal_date": "2020-01-01",
"date_of_last_keeper_change": "2020-01-01",
"date_Vic_issued": "2020-01-01",
"date_of_last_colour_change": "2020-01-01",
"min_kerbweight_kg": 1234,
"max_netpower_kw": 12,
"maximum_permissable_mass_kg": 1234,
"mot_expiry_date": "2020-01-01",
"mot_status": "Valid",
"keeper_changes_qty": 1,
"number_previous_colours": 1,
"number_seats": 5,
"power_weight_ratio_kw_kg": 12.34,
"is_scrapped": false,
"scrapped_date": "2020-01-01",
"driveby_soundlevel_db": 12,
"stationary_soundlevel_rpm": 1234,
"stationary_soundlevel_db": 12,
"tax_expiry_date": "2020-01-01",
"tax_status": "Taxed",
"max_braked_towing_weight_kg": 1234,
"max_unbraked_towing_weight_kg": 123,
"unscrapped": false,
"used_before_first_registration": true,
"date_v5c_issued": "2020-01-01",
"v5c_test_date": "2020-01-01",
"gross_vehicleweight_kg": 1234,
"manufactured_year": 2020,
"vehicle_identification_number": "ABCDE123456F78910",
"dvla_wheelplan": "2 AXLE RIGID BODY"
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
ids_code
e.g. AB001234
The IDS Code.
introduced_date
e.g. 2020-01-01
The date the vehicle was available in the market from
engine_capacity_cc
e.g. 1234
Engine capacity in cc
power_bhp
e.g. 123
Maximum BHP (Brake Horse Power) of this vehicle.
ids_fuel_type
e.g. Petrol
The IDS fuel type.
fuel_delivery
e.g. Turbo
The fuel delivery
ids_transmission_type
e.g. Manual
The IDS transmission type.
number_doors
e.g. 5
The number of doors
ids_body_type_desc
e.g. Hatchback
The IDS body type description
engine_configuration_type
e.g. 4 Cylinder In-Line
The engine configuration type.
ids_drivetrain_desc
e.g. Front Wheel
The IDS drivetrain description.
ids_manufacturer_code
e.g. NI
The IDS manufacturer code.
manufacturer_desc
e.g. NISSAN
Manufacturer description
ids_model_code
e.g. NIYF
The IDS model code.
ids_model_desc
e.g. Old QASHQAI model range
The IDS model description.
derivative_desc
e.g. QASHQAI HAT 1.6dCi ACENTA STOP/START
EV Database’s model variant
model_desc
e.g. Qashqai
The model description.
ids_model_tree_desc
e.g. Old Qashqai
The IDS model tree description.
ids_derivative_tree_desc
e.g. 1.6dCi Acenta Stop/Start
The IDS derivative tree description.
oem_model_range_desc
e.g. Qashqai Hatch
The model range description as supplied by manufacturer
ids_model_year
e.g. 12
The IDS model year.
full_model_year
e.g. 2020.25
The full model year
is_special_edition
e.g. false
Is this a special edition vehicle.
state
e.g. Old
The vehicle model year status.
is_commercial_vehicle
e.g. false
Is this a commercial vehicle.
P11D_price
e.g. 12345
The list price including options and delivery including VAT.
production_end_date
e.g. 2020-01-01
The date production of derivative ends.
vehicle_registration_mark
e.g. AB21 ABC
Vehicle registration number (VRM).
dvla_body_desc
e.g. 5 DOOR HATCHBACK
DVLA body description
co2_gkm
e.g. 123
CO2 in g/km
colour
e.g. RED
Exterior colour of vehicle
cherished_plate_on_vehicle
e.g. true
Is there a cherished plate on the vehicle.
manufactured_date
e.g. 2020-01-01
The date of manufacture
first_registration_date
e.g. 2020-01-01
Date of first registration
dvla_manufacturer_desc
e.g. NISSAN
DVLA manufacturer description
dvla_model_desc
e.g. QASHQAI ACENTA IS DCI
DVLA model description
engine_number
e.g. A12345678
Vehicle engine number
exported_date
e.g. 2020-01-01
Date vehicle was exported
is_exported
e.g. false
Vehicle is exported
dvla_fuel_desc
e.g. DIESEL
DVLA fuel description
imported_date
e.g. 2020-01-01
Date vehicle was imported
is_imported
e.g. false
Vehicle is imported
is_imported_NI
e.g. false
The vehicle is imported.
previous_keeper_acquisition_date
e.g. 2020-01-01
The previous keepers acquisition date
previous_keeper_disposal_date
e.g. 2020-01-01
The date the previous keeper disposed of the vehicle.
date_of_last_keeper_change
e.g. 2020-01-01
The date of last keeper change.
date_Vic_issued
e.g. 2020-01-01
The date the Vic was issued.
date_of_last_colour_change
e.g. 2020-01-01
Date of last colour change
min_kerbweight_kg
e.g. 1234
Minimum kerbweight in kg
max_netpower_kw
e.g. 12
Maximum net power in kw
maximum_permissable_mass_kg
e.g. 1234
Maximum permissable mass in kg
mot_expiry_date
e.g. 2020-01-01
The MOT expiry date.
mot_status
e.g. Valid
The MOT status.
keeper_changes_qty
e.g. 1
The keeper change quantity.
number_previous_colours
e.g. 1
The number of previous colours
number_seats
e.g. 5
Number of seats
power_weight_ratio_kw_kg
e.g. 12.34
Power to weight ratio kw per kg
is_scrapped
e.g. false
Has the vehicle been scrapped.
scrapped_date
e.g. 2020-01-01
The date the vehicle was scrapped.
driveby_soundlevel_db
e.g. 12
Driveby soundlevel in db
stationary_soundlevel_rpm
e.g. 1234
Stationary sound level rpm
stationary_soundlevel_db
e.g. 12
Stationary sound level in decibels
tax_expiry_date
e.g. 2020-01-01
The date the vehicle tax expires.
tax_status
e.g. Taxed
The tax status
max_braked_towing_weight_kg
e.g. 1234
Maximum braked towing weight in kg
max_unbraked_towing_weight_kg
e.g. 123
Maximum unbraked towing weight in kg
unscrapped
e.g. false
The vehicle is marked as unscrapped.
used_before_first_registration
e.g. true
Vehicle was used before DVLA/DLNI first registration
date_v5c_issued
e.g. 2020-01-01
The date the v5 was issued
v5c_test_date
e.g. 2020-01-01
The v5c test date.
gross_vehicleweight_kg
e.g. 1234
Gross vehicle weight in kg
manufactured_year
e.g. 2020
Year of manufacture.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
dvla_wheelplan
e.g. 2 AXLE RIGID BODY
DVLA wheelplan code where available
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