Additional data about electric cars to augment the data provided by other endpoints.
Key Features
Weights
Provides an array of vehicle, towing and load weight data points.
Dimensions
Vehicle, wheelbase and ground clearance dimensions and boot space capacities.
Drivetrain
Drivetrain and power details (bhp and kw).
Performance
Torque, acceleration and maximum speed.
Safety
NCAP ratings and year tested
Miscellaneous
Additional model and specification details
Sample Response
V1
Documentation
Introduction
This endpoint returns a set of weights, dimensions, drivetrain, performance & safety data for an electric car.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/evdatabase/uk/car/vehicledata/?evdb_vehicle_id=1234
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/car/vehicledata/?evdb_vehicle_id=1234
Request Parameters
evdb_vehicle_id
mandatory, string, e.g. 1234
EV Database Vehicle ID
Sample Response
{
"success": true,
"result": {
"dimensions_weights": {
"vehicle_length_mm": 4839,
"vehicle_width_mm": 2008,
"vehicle_width_inc_mirrors_mm": 2139,
"vehicle_height_mm": 1544,
"is_length_width_height_estimated": true,
"ground_clearance_mm": 166,
"vehicle_wheelbase_mm": 2999,
"is_wheelbase_estimated": false,
"vehicleweight_kg": 2232,
"is_weight_estimated": false,
"gross_vehicleweight_kg": 2555,
"payload_weight_kg": 586,
"bootspace_min_litres": 526,
"bootspace_max_litres": 1536,
"bootspace_front_trunk_litres": 15,
"is_tow_hook_allowed": true,
"max_unbraked_towing_weight_kg": 750,
"max_braked_towing_weight_kg": 1500,
"is_towing_weight_estimated": false,
"max_vertical_towing_load_weight_kg": 100,
"max_roof_load_kg": 75
},
"drivetrain_performance": {
"drivetrain_desc": "Rear Wheel Drive",
"is_drivetrain_desc_estimated": false,
"drivetrain_power_kw": 200,
"drivetrain_power_bhp": 268,
"is_drivetrain_power_estimated": false,
"torque_nm": 343,
"is_torque_estimated": false,
"acceleration_0to62_mph_seconds": 7.4,
"is_acceleration_estimated": false,
"top_speed_mph": 69,
"is_top_speed_estimated": false
},
"safety": {
"ncap_overall_rating": 5,
"ncap_rating_year": 2021,
"ncap_adult_occupant_protection_percentage": 92,
"ncap_child_occupant_protection_percentage": 86,
"ncap_vulnerable_road_user_percentage": 69,
"ncap_safety_assist_percentage": 82
},
"miscellaneous": {
"body_type_desc": "Liftback Saloon",
"number_seats": 5,
"is_roof_rails_standard": false,
"is_isofix_standard": true,
"number_seats_isofix": 2,
"turning_circle_kerb_to_kerb_m": 11.6,
"vehicle_platform_desc": "GEELY SEA1",
"is_dedicated_ev_platform": true,
"is_heatpump_available": true,
"is_heatpump_standard": true
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_length_mm
e.g. 4839
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_width_mm
e.g. 2008
Overall width, including the wing mirrors in millimetres.
vehicle_width_inc_mirrors_mm
e.g. 2139
Vehicle width including mirrors in mm
vehicle_height_mm
e.g. 1544
Overall height of the vehicle, including roof-bars or aerial in millimetres.
is_length_width_height_estimated
e.g. true
Is the length, width and height estimated
ground_clearance_mm
e.g. 166
The ground clearance in mm
vehicle_wheelbase_mm
e.g. 2999
Measurement between the centre of the wheels on either side of the vehicle in millimetres.
is_wheelbase_estimated
e.g. false
Is the wheelbase estimated
vehicleweight_kg
e.g. 2232
Vehicle weight in kilograms
is_weight_estimated
e.g. false
Is the vehicle weight estimated
gross_vehicleweight_kg
e.g. 2555
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
payload_weight_kg
e.g. 586
Difference between the Kerb Weight and the Gross Weight in kilograms.
bootspace_min_litres
e.g. 526
Minimum bootspace in litres
bootspace_max_litres
e.g. 1536
Maximum bootspace in litres
bootspace_front_trunk_litres
e.g. 15
Boot space front trunk in litres
is_tow_hook_allowed
e.g. true
Is tow hook allowed
max_unbraked_towing_weight_kg
e.g. 750
Maximum unbraked towing weight in kilograms.
max_braked_towing_weight_kg
e.g. 1500
Maximum braked towing weight in kilograms,
is_towing_weight_estimated
e.g. false
Is towing weight estimated
max_vertical_towing_load_weight_kg
e.g. 100
Maximum vertical towing load weight in kg
max_roof_load_kg
e.g. 75
Maximum roof load in kilograms
drivetrain_desc
e.g. Rear Wheel Drive
Drivetrain
is_drivetrain_desc_estimated
e.g. false
Is drivetrain description estimated
drivetrain_power_kw
e.g. 200
Drivetrain power in kilowatts
drivetrain_power_bhp
e.g. 268
Drivetrain power bhp
is_drivetrain_power_estimated
e.g. false
Is drivetrain power estimated
torque_nm
e.g. 343
Maximum power described in Torque Nm (Torque Newton Metres).
is_torque_estimated
e.g. false
Is torque estimated
acceleration_0to62_mph_seconds
e.g. 7.4
Acceleration - number of seconds to go from Zero to 62 mph
is_acceleration_estimated
e.g. false
Is acceleration estimated
top_speed_mph
e.g. 69
Manufacturer's claimed top speed in miles per hour
is_top_speed_estimated
e.g. false
Is top speed estimated
ncap_overall_rating
e.g. 5
NCAP (The European New Car Assessment Programme) safety rating as assigned by NCAP.
ncap_rating_year
e.g. 2021
ncap overall rating
ncap_adult_occupant_protection_percentage
e.g. 92
NCAP percentage - rated level of protection for a adult occupant, in the event of an impact.
ncap_child_occupant_protection_percentage
e.g. 86
NCAP percentage - rated level of protection for a child occupant, in the event of an impact.
ncap_vulnerable_road_user_percentage
e.g. 69
ncap vulnerable road user percentage
ncap_safety_assist_percentage
e.g. 82
NCAP percentage - rated level of the vehicles breaking and warning systems.
body_type_desc
e.g. Liftback Saloon
The body type description
number_seats
e.g. 5
Number of seats.
is_roof_rails_standard
e.g. false
Are roof rails standard
is_isofix_standard
e.g. true
Is ISOFIX standard
number_seats_isofix
e.g. 2
Number of ISOFIX seats
turning_circle_kerb_to_kerb_m
e.g. 11.6
Turning circle from kerb to kerb in metres
vehicle_platform_desc
e.g. GEELY SEA1
Vehicle platform description
is_dedicated_ev_platform
e.g. true
Is dedicated EV platform
is_heatpump_available
e.g. true
Is a heat pump available
is_heatpump_standard
e.g. true
Is a heat pump standard
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