Unlock compatibility and discover the power of EV Database.
Quickly and easily identify the correct vehicle and its unique ID, and use this as the key to accessing in-depth data on real world range, efficiency, charging and pence-per-mile performance data.
Take advantage of free implementation consultancy and achieve compatibility with your existing data landscape.
Key Features
Text & Parameter-Based Search
Easily identify the correct EV Database derivative
Compatibility Solved
Enables the use of EV Database data in any data landscape
Confidence Scoring
Provides an array of confidence scored results
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 vehicle in EV Database using a combination of description, technical data and the 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/evdatabase/uk/idsearch/?manufacturer_desc=fiat&model_range_desc=ducato&derivative_desc=e-ducato&battery_capacity_usable_kwh=76&battery_capacity_kwh=100&battery_volts=400&gross_vehicleweight_kg=3500&drivetrain_desc=Front Wheel Drive&is_current=true®istration_date=2024-01-01&vehicle_type=van
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/idsearch/?manufacturer_desc=fiat&model_range_desc=ducato&derivative_desc=e-ducato&battery_capacity_usable_kwh=76&battery_capacity_kwh=100&battery_volts=400&gross_vehicleweight_kg=3500&drivetrain_desc=Front Wheel Drive&is_current=true®istration_date=2024-01-01&vehicle_type=van
Request Parameters
manufacturer_desc
mandatory, string, e.g. fiat
Manufacturer description
model_range_desc
mandatory, string, e.g. ducato
Model range description
derivative_desc
mandatory, string, e.g. e-ducato
The deriative description
battery_capacity_usable_kwh
optional, string, e.g. 76
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
battery_capacity_kwh
optional, string, e.g. 100
Battery capacity in kwh e.g 100
battery_volts
optional, string, e.g. 400
Nominal battery voltage as defined by the manufacturer
gross_vehicleweight_kg
optional, string, e.g. 3500
Gross vehicle weight in kilograms
drivetrain_desc
optional, string, e.g. Front Wheel Drive
Drivetrain
is_current
optional, string, e.g. true
Is the vehicle currently available to order (includes pre-order open)
registration_date
optional, string, e.g. 2024-01-01
Date the vehicle was first registered in the UK
vehicle_type
optional, string, e.g. van
Vehicle type
Sample Response
{
"success": true,
"result": [
{
"evdb_vehicle_id": 1234,
"vehicle_type": "van",
"manufacturer_desc": "Fiat",
"model_range_desc": "Ducato",
"derivative_desc": "e-Ducato",
"model_length_desc": "M",
"model_height_desc": "H2",
"battery_type": "Lithium-ion",
"battery_capacity_usable_kwh": 42,
"battery_capacity_kwh": 47,
"battery_volts": 400,
"gross_vehicleweight_kg": 3500,
"drivetrain_desc": "Front Wheel Drive",
"introduced_date": "2020-12-01",
"discontinued_date": "null",
"is_available_to_order": true,
"confidence_scoring": {
"manufacturer_desc_score": 100,
"model_range_desc_score": 100,
"derivative_desc_score": 100,
"badged_battery_capacity_kwh_score": 83,
"battery_capacity_kwh_score": 47,
"battery_capacity_usable_kwh_score": 66,
"gross_vehicleweight_kg_score": 100,
"battery_volts_score": 100,
"drivetrain_desc_score": 100,
"availability_score": 100,
"overall_score": 69.6
}
}
],
"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. 1234
EV Database Vehicle ID
vehicle_type
e.g. van
Class of vehicle.
manufacturer_desc
e.g. Fiat
Manufacturer description
model_range_desc
e.g. Ducato
Model range description.
derivative_desc
e.g. e-Ducato
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. 42
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
battery_capacity_kwh
e.g. 47
Battery capacity in kwh
battery_volts
e.g. 400
Voltage of the battery.
gross_vehicleweight_kg
e.g. 3500
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
drivetrain_desc
e.g. Front Wheel Drive
Drivetrain
introduced_date
e.g. 2020-12-01
The date the vehicle was available in the market from
discontinued_date
e.g. null
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. 100
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. 83
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.
battery_capacity_kwh_score
e.g. 47
Likelihood this vehicle has the chosen battery capacity in kilowatt hours based on input parameters. The higher the confidence score the more likely this is the chosen battery capacity.
battery_capacity_usable_kwh_score
e.g. 66
Likelihood this vehicle has the chosen usable battery capacity kilowatt based on input parameters. The higher the confidence score the more likely this is the chosen usable battery capacity.
gross_vehicleweight_kg_score
e.g. 100
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.
battery_volts_score
e.g. 100
Likelihood this vehicle has the chosen battery voltage based on input parameters. The higher the confidence score the more likely this is the chosen battery voltage.
drivetrain_desc_score
e.g. 100
Likelihood this vehicle has the chosen drivetrain description based on input parameters. The higher the confidence score the more likely this is the chosen drivetrain description.
availability_score
e.g. 100
The likelihood this vehicle is currently available to order.
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