Introduction
This endpoint returns a vehicle from an IDS code and provides technical data and features based on 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/solifi/inventoryaugmentationfromidscode?ids_code=AB012345&effective_date=2020-01-01
Example Sandbox Request
https://sandbox.oneautoapi.com/solifi/inventoryaugmentationfromidscode?ids_code=AB012345&effective_date=2020-01-01
Request Parameters
ids_code
mandatory, string, e.g. AB012345
IDS code
effective_date
optional, string, e.g. 2020-01-01
Returns the features relevant to the chosen vehicle for that moment in time.
Sample Response
{
"success": true,
"result": {
"basic_vehicle_info": {
"ids_code": "AB012345",
"effective_date": "2020-01-01",
"homologation_class": "M1",
"asset_type": "car",
"manufacturer_desc": "Volkswagen",
"model_range_desc": "TIGUAN",
"model_sub_range_desc": "TIGUAN",
"derivative_desc": "Tiguan 1.5 TSI 150 R-Line Edition DSG7",
"vehicle_desc": "Volkswagen Tiguan 1.5 TSI 150 R-Line Edition DSG7",
"full_model_year": 2021.25,
"trim_level_desc": "R LINE EDITION",
"ids_body_type_desc": "Station Wagon",
"ids_expanded_body_type_desc": "Medium Crossover/SUV",
"ids_fuel_type_desc": "Petrol",
"ids_transmission_desc": "Automatic",
"ids_drivetrain_type_desc": "Front Wheel",
"number_seats": 5,
"number_doors": 5,
"number_gears": 7,
"number_axles": 2
},
"insurance_data": {
"insurance_group_1to50": "50"
},
"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,
"ground_clearance_mm": 123,
"bootspace_litres": 12.345678910112,
"payload_length_mm": 1234,
"payload_width_mm": 1234,
"payload_height_mm": 1234,
"payload_weight_kg": 123,
"payload_volume_cubicmetres": 123,
"payload_width_between_wheel_arches_mm": 1234,
"nose_weight_kg": 123,
"roof_load_limit_kg": 123,
"turning_circle_kerb_to_kerb_metres": 12.3,
"min_kerbweight_kg": 1234,
"gross_vehicleweight_kg": 1234,
"max_braked_towing_weight_kg": 123,
"max_unbraked_towing_weight_kg": 123
},
"engine_data": {
"engine_capacity_cc": 1234,
"fuel_delivery": "Turbo",
"fuel_capacity_litres": 12,
"is_ad_blue": true,
"ad_blue_range_miles": 123,
"number_cylinders": 3,
"cylinder_arrangement": "4 Cylinder In-Line",
"valves_per_cylinder": 5,
"power_ps": 12.3456789101112,
"power_bhp": 123.5,
"power_kw": 12.3456789101112,
"torque_nm": 123,
"torque_rpm": 1234,
"emission_class": "Euro 6",
"rde_type": 2,
"co2_gkm": 123,
"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": {
"battery_range_miles": 123,
"electric_consumption_miles_kwh_calculated": 123,
"battery_volts": 123,
"battery_capacity_kwh": 12.3,
"battery_capacity_usable_kwh": 12.3,
"is_battery_leased": true
},
"features_data": [
{
"feature_desc": "12Volt Socket in Front Centre Console",
"feature_generic_desc": "12V Socket",
"feature_status": "Optional",
"factory_code": "1AB",
"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
ids_code
e.g. AB012345
The IDS Code.
effective_date
e.g. 2020-01-01
Return the pricing relevant to the chosen vehicle for that moment in time.
homologation_class
e.g. M1
The homologation class
manufacturer_desc
e.g. Volkswagen
Manufacturer description
model_range_desc
e.g. TIGUAN
Model range description.
model_sub_range_desc
e.g. TIGUAN
The model sub range description
derivative_desc
e.g. Tiguan 1.5 TSI 150 R-Line Edition DSG7
Derivative description.
vehicle_desc
e.g. Volkswagen Tiguan 1.5 TSI 150 R-Line Edition DSG7
The Vehicle description
full_model_year
e.g. 2021.25
The full model year
trim_level_desc
e.g. R LINE EDITION
The trim level description
ids_body_type_desc
e.g. Station Wagon
The IDS body type description
ids_expanded_body_type_desc
e.g. Medium Crossover/SUV
The expanded IDS body type description
ids_fuel_type_desc
e.g. Petrol
The IDS fuel type
ids_transmission_desc
e.g. Automatic
The IDS transmission description
ids_drivetrain_type_desc
e.g. Front Wheel
The IDS drivetrain description
insurance_group_1to50
e.g. 50
The 1-50 insurance group
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.
ground_clearance_mm
e.g. 123
The ground clearance in mm
bootspace_litres
e.g. 12.345678910112
The bootspace 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
payload_width_between_wheel_arches_mm
e.g. 1234
The payload width between wheel arches in mm
nose_weight_kg
e.g. 123
The nose weight in kg
roof_load_limit_kg
e.g. 123
The roof load limit in kg
turning_circle_kerb_to_kerb_metres
e.g. 12.3
The turning circle kerb to kerb in 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.
max_braked_towing_weight_kg
e.g. 123
Maximum braked towing weight in kilograms,
max_unbraked_towing_weight_kg
e.g. 123
Maximum unbraked towing weight in kilograms.
engine_capacity_cc
e.g. 1234
Cubic capacity of the engine.
fuel_delivery
e.g. Turbo
Fuel delivery method.
fuel_capacity_litres
e.g. 12
Fuel capacity in litres.
is_ad_blue
e.g. true
Does the vehicle have an ad blue tank
ad_blue_range_miles
e.g. 123
The ad blue range
number_cylinders
e.g. 3
Number of cylinders within the engine.
cylinder_arrangement
e.g. 4 Cylinder In-Line
Arrangement of the cylinders within the engine.
valves_per_cylinder
e.g. 5
Number of valves per cylinder.
power_ps
e.g. 12.3456789101112
Power PS.
power_bhp
e.g. 123.5
Maximum BHP (Brake Horse Power) of this vehicle.
power_kw
e.g. 12.3456789101112
The maximum net power in kw
torque_nm
e.g. 123
Maximum power described in Torque Nm (Torque Newton Metres).
torque_rpm
e.g. 1234
Maximum power described in rpm (Revolutions Per Minute).
emission_class
e.g. Euro 6
European emission standard. Value indicates the emission levels in line with the age of the vehicle.
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)
battery_range_miles
e.g. 123
The battery's range in miles
electric_consumption_miles_kwh_calculated
e.g. 123
The electric vehicle's calculated consumption miles per kwh
battery_volts
e.g. 123
Voltage of the battery.
battery_capacity_kwh
e.g. 12.3
Battery capacity in kwh
battery_capacity_usable_kwh
e.g. 12.3
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
is_battery_leased
e.g. true
Is the battery leased
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)
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