Real range and efficiency data for electric cars, allowing users to accurately estimate how a vehicle will perform in a range of operating conditions. Provides support for retail and fleet decision making, ensuring vehicles selected are suitable for purpose.
Key Features
Range Data
Provides real range estimate, alongside WLTP and/or NEDC test results
Driving Cycles
Real range estimates for city, combined and highway driving
Weather Conditions
Real range estimates for cold, mild and warm weather conditions
Energy Consumption
Measured in watt-hours-per-mile and miles-per-kwh for flexible implementation
Equivalent Fuel Energy
Provides the comparable fuel energy in MPG for fleet planning and consultancy
Battery Data
In-depth battery specification including chemistry, thermal management, cell configuration and warranty details
Sample Response
V1
Documentation
Introduction
This endpoint returns electric car range and efficiency data including proprietary range and efficiency estimates.
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/rangeefficiencybattery/?evdb_vehicle_id=1234
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/car/rangeefficiencybattery/?evdb_vehicle_id=1234
Request Parameters
evdb_vehicle_id
mandatory, string, e.g. 1234
EV Database Vehicle ID
Sample Response
{
"success": true,
"result": {
"range": {
"wltp_pure_electric_range_combined_test_energy_high_miles": 331,
"wltp_pure_electric_range_combined_test_energy_low_miles": 386,
"is_wltp_range_estimated": false,
"nedc_max_ev_range_miles": 118,
"is_nedc_range_estimated": false,
"evdb_real_electric_range_miles": 325,
"evdb_real_electric_range_mode": "estimation",
"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
},
"efficiency": {
"wltp_electric_consumption_combined_test_energy_low_watt_hours_per_mile": 257.5,
"wltp_electric_consumption_combined_test_energy_low_miles_per_kwh": 3.9,
"wltp_electric_consumption_equivalent_fuel_energy_test_energy_low_mpg": 152.5,
"wltp_combined_test_energy_low_co2_gkm": 0,
"wltp_electric_consumption_combined_test_energy_high_watt_hours_per_mile": 306.5,
"wltp_electric_consumption_combined_test_energy_high_miles_per_kwh": 3.3,
"wltp_electric_consumption_equivalent_fuel_energy_test_energy_high_mpg": 129.5,
"wltp_combined_test_energy_high_co2_gkm": 0,
"nedc_electric_consumption_watt_hours_per_mile": 257.5,
"nedc_electric_consumption_miles_per_kwh": 5.2,
"nedc_electric_consumption_equivalent_fuel_energy_mpg": 241.5,
"real_electric_consumption_watt_hours_per_mile": 278.5,
"real_electric_consumption_miles_per_kwh": 3.6,
"real_electric_consumption_equivalent_fuel_energy_mpg": 148.5,
"evdb_real_electric_consumption_highway_cold_watt_hours_per_mile": 379.5,
"evdb_real_electric_consumption_combined_cold_watt_hours_per_mile": 330.5,
"evdb_real_electric_consumption_city_cold_watt_hours_per_mile": 292.5,
"evdb_real_electric_consumption_highway_mild_watt_hours_per_mile": 333.5,
"evdb_real_electric_consumption_combined_mild_watt_hours_per_mile": 283.5,
"evdb_real_electric_consumption_city_mild_watt_hours_per_mile": 242.5,
"evdb_real_electric_consumption_highway_warm_watt_hours_per_mile": 287.5,
"evdb_real_electric_consumption_combined_warm_watt_hours_per_mile": 237.5,
"evdb_real_electric_consumption_city_warm_watt_hours_per_mile": 193.5
},
"battery": {
"battery_type": "Lithium-ion",
"battery_thermal_management_system": "Active Liquid",
"battery_chemistry": "NCM622",
"battery_manufacturer": "LGES",
"battery_architecture": "400 V",
"battery_volts": 350,
"battery_modules_qty": 12,
"battery_cells_configuration": "98s3p",
"battery_weight_kg": 349,
"battery_warranty_years": 10,
"battery_warranty_mileage": 100000
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
wltp_pure_electric_range_combined_test_energy_high_miles
e.g. 331
WLTP pure electric range combined miles test energy high
wltp_pure_electric_range_combined_test_energy_low_miles
e.g. 386
WLTP pure electric range combined miles test energy low
is_wltp_range_estimated
e.g. false
Is the WLTP range estimated
nedc_max_ev_range_miles
e.g. 118
NEDC maximum ev range in miles
is_nedc_range_estimated
e.g. false
IIs the NEDC range estimated
evdb_real_electric_range_miles
e.g. 325
EV Database electric range in miles
evdb_real_electric_range_mode
e.g. estimation
EV Database real electric range mode
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
wltp_electric_consumption_combined_test_energy_low_watt_hours_per_mile
e.g. 257.5
WLTP electric consumption per mile in watts based on test energy low in the most efficient trim
wltp_electric_consumption_combined_test_energy_low_miles_per_kwh
e.g. 3.9
WLTP electric consumption in miles per kwh based on test energy low in the most efficient trim
wltp_electric_consumption_equivalent_fuel_energy_test_energy_low_mpg
e.g. 152.5
WLTP electric consumption equivalent fuel energy miles per gallon test energy low
wltp_combined_test_energy_low_co2_gkm
e.g. 0
WLTP combined CO2 g/km test energy low / most efficient trim
wltp_electric_consumption_combined_test_energy_high_watt_hours_per_mile
e.g. 306.5
WLTP electric consumption miles kilowatt-hour test energy high
wltp_electric_consumption_combined_test_energy_high_miles_per_kwh
e.g. 3.3
wltp_electric_consumption_combined_test_energy_high_miles_per_kwh
wltp_electric_consumption_equivalent_fuel_energy_test_energy_high_mpg
e.g. 129.5
The equivalent fuel energy expressed as petrol miles per gallon for test energy low in the least efficient trim
wltp_combined_test_energy_high_co2_gkm
e.g. 0
WLTP combined CO2 g/km test energy high / least efficient trim
nedc_electric_consumption_watt_hours_per_mile
e.g. 257.5
NEDC electric consumption in watts per mile
nedc_electric_consumption_miles_per_kwh
e.g. 5.2
NEDC electric consumption in miles per kwh
nedc_electric_consumption_equivalent_fuel_energy_mpg
e.g. 241.5
The equivalent fuel energy expressed as petrol miles per gallon for NEDC electric consumption
real_electric_consumption_watt_hours_per_mile
e.g. 278.5
Calculated watts per mile based on real range and usable battery capacity
real_electric_consumption_miles_per_kwh
e.g. 3.6
Calculated miles per kwh based on real range and usable battery capacity
real_electric_consumption_equivalent_fuel_energy_mpg
e.g. 148.5
The equivalent fuel energy expressed as petrol miles per gallon based on real efficiency calculated from real range and usable battery capacity
evdb_real_electric_consumption_highway_cold_watt_hours_per_mile
e.g. 379.5
EV Database real electric consumption in miles per kilowatt-hours for highway driving in temperatures of -10c using heating
evdb_real_electric_consumption_combined_cold_watt_hours_per_mile
e.g. 330.5
EV Database real electric consumption in miles per kilowatt-hours for highway and city driving in temperatures of -10c using heating
evdb_real_electric_consumption_city_cold_watt_hours_per_mile
e.g. 292.5
EV Database real electric consumption in miles per kilowatt-hours for city driving in temperatures of -10c using heating
evdb_real_electric_consumption_highway_mild_watt_hours_per_mile
e.g. 333.5
EV Database real electric consumption in miles per kilowatt-hours for highway driving in mild conditions of +10c
evdb_real_electric_consumption_combined_mild_watt_hours_per_mile
e.g. 283.5
EV Database real electric consumption in miles per kilowatt-hours for highway and city driving in mild conditions of +10c
evdb_real_electric_consumption_city_mild_watt_hours_per_mile
e.g. 242.5
EV Database real electric consumption in miles per kilowatt-hours for city driving in mild conditions of +10c
evdb_real_electric_consumption_highway_warm_watt_hours_per_mile
e.g. 287.5
EV Database real electric consumption in miles per kilowatt-hours for highway driving in warm conditions of 23c, using A/C
evdb_real_electric_consumption_combined_warm_watt_hours_per_mile
e.g. 237.5
EV Database real electric consumption in miles per kilowatt-hours for highway and city driving in warm conditions of 23c, using A/C
evdb_real_electric_consumption_city_warm_watt_hours_per_mile
e.g. 193.5
EV Database real electric consumption in miles per kilowatt-hours for city driving in warm conditions of 23c, using A/C
battery_type
e.g. Lithium-ion
Battery type.
battery_thermal_management_system
e.g. Active Liquid
Battery type
battery_chemistry
e.g. NCM622
Battery chemistry, may include ratios
battery_manufacturer
e.g. LGES
Battery manufacturer
battery_architecture
e.g. 400 V
Battery and drivetrain architecture
battery_volts
e.g. 350
Voltage of the battery.
battery_modules_qty
e.g. 12
Number of battery modules
battery_cells_configuration
e.g. 98s3p
Number of cells in the battery pack, can include cell configuration
battery_weight_kg
e.g. 349
Weight of the battery in kilograms
battery_warranty_years
e.g. 10
Battery warranty period in years
battery_warranty_mileage
e.g. 100000
Number of miles (from new) the battery is covered under a manufacturers warranty.
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