Quickly and easily identify the correct vehicle from a registration mark.
Use the EV Database ID as a key to access in-depth data on real world range, efficiency, charging and pence-per-mile performance data.
Key Features
VRM-based Lookup
Easily identify vehicles by registration mark
Compatibility Solved
Enables accurate lookup in any website or software application
Confidence Scored
Confidence scored results can be used to automate, or power an ordered pick list for final selection by the user
Structured Vehicle Descriptions
Manufacturer, model range, derivative, height and length descriptions (as appropriate)
Battery Data
Actual and usable battery capacity and voltage
Technical Data
Gross vehicle weight and drivetrain as homologated
Sample Response
V1
Documentation
Introduction
This endpoint identifies the matching EV Database Vehicle ID using a VRM.
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/searchfromvrm?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/searchfromvrm?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number (VRM).
Sample Response
{
"success": true,
"result": {
"evdb_results": [
{
"evdb_vehicle_id": 2020,
"vehicle_type": "car",
"manufacturer_desc": "Skoda",
"model_range_desc": "Enyaq",
"model_desc": "Enyaq",
"derivative_desc": "85",
"model_length_desc": "M",
"model_height_desc": "H2",
"battery_type": "Lithium-ion",
"battery_capacity_usable_kwh": 77,
"battery_capacity_kwh": 82,
"battery_volts": 352,
"gross_vehicleweight_kg": 2650,
"drivetrain_desc": "Rear Wheel Drive",
"introduced_date": "2023-10-01",
"discontinued_date": "2024-01-01",
"is_available_to_order": true,
"confidence_scoring": {
"manufacturer_desc_score": 100,
"model_range_desc_score": 100,
"derivative_desc_score": 82,
"badged_battery_capacity_kwh_score": 100,
"gross_vehicleweight_kg_score": 91,
"availability_score": 84,
"overall_score": 91.22
}
}
]
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
evdb_vehicle_id
e.g. 2020
EV Database Vehicle ID
vehicle_type
e.g. car
Class of vehicle.
manufacturer_desc
e.g. Skoda
Manufacturer description
model_range_desc
e.g. Enyaq
Model range description.
model_desc
e.g. Enyaq
Model description.
derivative_desc
e.g. 85
Derivative description.
model_length_desc
e.g. M
The model length description
model_height_desc
e.g. H2
The model height description
battery_type
e.g. Lithium-ion
Battery type.
battery_capacity_usable_kwh
e.g. 77
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
battery_capacity_kwh
e.g. 82
Battery capacity in kwh
battery_volts
e.g. 352
Voltage of the battery.
gross_vehicleweight_kg
e.g. 2650
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
drivetrain_desc
e.g. Rear Wheel Drive
Drivetrain
introduced_date
e.g. 2023-10-01
The date the vehicle was available in the market from
discontinued_date
e.g. 2024-01-01
The date the vehicle was available to in the market
is_available_to_order
e.g. true
Likelihood this vehicle is currently available to order.
manufacturer_desc_score
e.g. 100
Likelihood this is the chosen manufacturer description based on input parameters. The higher the confidence score the more likely this is the chosen manufacturer.
model_range_desc_score
e.g. 100
Likelihood this is the chosen model range description based on input parameters. The higher the confidence score the more likely this is the chosen model range.
derivative_desc_score
e.g. 82
Likelihood this is the chosen derivative description based on input parameters. The higher the confidence score the more likely this is the chosen derivative.
badged_battery_capacity_kwh_score
e.g. 100
Likelihood this vehicle has the chosen badged battery capacity in kilowatt hours based on input parameters. The higher the confidence score the more likely this is the chosen badged battery capacity.
gross_vehicleweight_kg_score
e.g. 91
Likelihood this vehicle has the chosen gross vehicle weight in kilograms based on input parameters. The higher the confidence score the more likely this is the chosen gross vehicle weight.
availability_score
e.g. 84
The likelihood this vehicle is currently available to order.
overall_score
e.g. 91.22
Overall likelihood this is the chosen vehicle based on input parameters. The higher the confidence score the more likely this is the chosen vehicle.
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