Provide van buyers with the ability to evaluate whether an electric vehicle will be suitable for their needs, with real world data on range and pence-per-mile costs in 27 different driving, weather and charging scenarios.
Key Features
Real Range
Expected range in 9 different driving and weather scenarios
Electricity Tariffs
Benchmark electricity tariffs for on-premises and public charging
Pence Per Mile
Understand real world performance in 27 different driving, weather and charging scenarios
Interactive Tools for Buyers
Help buyers understand the real world performance and suitability of an EV in different use scenarios
Journey Planning
Use in combination with other data sources to help plan journeys and predict costs
Mobility Solutions & Fleet Strategy
Supports informed decision making for individual journeys and the suitability of an electric vehicle for individuals and roles
Sample Response
V1
Documentation
Introduction
This endpoint returns real world data on range and pence-per-mile electric cost.
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/van/pencepermile/?evdb_vehicle_id=12345
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/van/pencepermile/?evdb_vehicle_id=12345
Request Parameters
evdb_vehicle_id
mandatory, string, e.g. 12345
EV Database Vehicle ID
Sample Response
{
"success": true,
"result": {
"evdb_vehicle_id": 1234,
"unit_costs": {
"pence_per_kwh_electric_details": {
"domestic_cheap": 7.5,
"domestic_standard": 34,
"public_charger": 85
}
},
"range_data": {
"evdb_real_electric_range_highway_cold_miles": 235,
"evdb_real_electric_range_combined_cold_miles": 270,
"evdb_real_electric_range_city_cold_miles": 305,
"evdb_real_electric_range_highway_mild_miles": 272.5,
"evdb_real_electric_range_combined_mild_miles": 322.5,
"evdb_real_electric_range_city_mild_miles": 382.5,
"evdb_real_electric_range_highway_warm_miles": 310,
"evdb_real_electric_range_combined_warm_miles": 375,
"evdb_real_electric_range_city_warm_miles": 460
},
"pence_per_mile_data": {
"pence_per_mile_highway_cold": {
"domestic_cheap": 2.91,
"domestic_standard": 13.91,
"public_charger": 32.98
},
"pence_per_mile_combined_cold": {
"domestic_cheap": 2.46,
"domestic_standard": 11.15,
"public_charger": 27.88
},
"pence_per_mile_city_cold": {
"domestic_cheap": 2.08,
"domestic_standard": 9.45,
"public_charger": 23.63
},
"pence_per_mile_highway_mild": {
"domestic_cheap": 2.6,
"domestic_standard": 11.78,
"public_charger": 29.45
},
"pence_per_mile_combined_mild": {
"domestic_cheap": 2.14,
"domestic_standard": 9.69,
"public_charger": 24.23
},
"pence_per_mile_city_mild": {
"domestic_cheap": 1.74,
"domestic_standard": 7.89,
"public_charger": 19.72
},
"pence_per_mile_highway_warm": {
"domestic_cheap": 1.95,
"domestic_standard": 8.1,
"public_charger": 25.93
},
"pence_per_mile_combined_warm": {
"domestic_cheap": 1.81,
"domestic_standard": 8.23,
"public_charger": 20.57
},
"pence_per_mile_city_warm": {
"domestic_cheap": 1.4,
"domestic_standard": 6.32,
"public_charger": 15.81
}
}
},
"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
domestic_cheap
e.g. 7.5
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 34
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 85
Public charger unit price pence per kilowatt hour (typical EV tariff)
evdb_real_electric_range_highway_cold_miles
e.g. 235
EV Database electric range in miles for highway driving in temperatures of -10c using heating
evdb_real_electric_range_combined_cold_miles
e.g. 270
EV Database electric range in miles for combined city and highway driving in temperatures of -10c
evdb_real_electric_range_city_cold_miles
e.g. 305
EV Database electric range in miles for city driving in temperatures of -10c using heating
evdb_real_electric_range_highway_mild_miles
e.g. 272.5
EV Database electric range in miles for highway driving in mild conditions of +10c
evdb_real_electric_range_combined_mild_miles
e.g. 322.5
EV Database electric range in miles for combined city and highway driving in mild conditions of +10c
evdb_real_electric_range_city_mild_miles
e.g. 382.5
EV Database electric range in miles for city driving in mild conditions of +10c
evdb_real_electric_range_highway_warm_miles
e.g. 310
EV Database electric range in miles for highway driving in warm conditions of 23c, using A/C
evdb_real_electric_range_combined_warm_miles
e.g. 375
EV Database electric range in miles for combined city and highway driving in warm conditions of, 23c, using A/C.
evdb_real_electric_range_city_warm_miles
e.g. 460
EV Database electric range in miles for city driving in warm conditions of 23c, using A/C
domestic_cheap
e.g. 2.91
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 13.91
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 32.98
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 2.46
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 11.15
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 27.88
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 2.08
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 9.45
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 23.63
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 2.6
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 11.78
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 29.45
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 2.14
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 9.69
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 24.23
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 1.74
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 7.89
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 19.72
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 1.95
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 8.1
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 25.93
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 1.81
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 8.23
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 20.57
Public charger unit price pence per kilowatt hour (typical EV tariff)
domestic_cheap
e.g. 1.4
Domestic cheap unit price pence per kilowatt hour (typical EV tariff)
domestic_standard
e.g. 6.32
Domestic standard unit price pence per kilowatt hour (typical EV tariff)
public_charger
e.g. 15.81
Public charger unit price pence per kilowatt hour (typical EV tariff)
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