Supercharge your marketing of used EVs.
Increase buyer confidence in battery health with an independent estimate of range based on current age and mileage, compared to real range when new and data on remaining battery warranty.
Includes actual test results if the vehicle has previously been tested by ClearWatt.
Key Features
VRM-based Lookup
Easily identify vehicles by registration mark
Manufacturer-Independent Data
ClearWatt test hundreds of vehicles a year to produce highly accurate data
Increase Buyer Confidence
Battery longevity is the #1 concern of potential used EV buyers.
Expected Range
The expected range now based on current age and mileage
Remaining Battery Warranty
The balance of manufacturer warranty remaining, in months and miles
Actual Test Results
If the vehicle has been previously tested by ClearWatt
Sample Response
V1
Documentation
Introduction
This endpoint provides realistic range expectations based on vehicle age and mileage, compared to benchmark real range when new.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/clearwatt/expectedrangefromvrm?vehicle_registration_mark=AB21ABC¤t_mileage=12345
Example Sandbox Request
https://sandbox.oneautoapi.com/clearwatt/expectedrangefromvrm?vehicle_registration_mark=AB21ABC¤t_mileage=12345
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
current_mileage
mandatory, string, e.g. 12345
The current mileage of the vehicle in full
Sample Response
{
"success": true,
"result": {
"vehicle_info": {
"vehicle_registration_mark": "AB21ABC",
"current_mileage": 35000,
"manufacturer_desc": "Jaguar",
"model_range_desc": "I-Pace",
"variant_desc": "EV400",
"manufactured_year": 2020,
"battery_capacity_kwh": 90,
"usable_battery_capacity_kwh": 84.7,
"wltp_pure_electric_range_combined_miles_test_energy_low": 292
},
"remaining_battery_warranty": {
"miles": 65000,
"months": 59
},
"benchmark_real_electric_range_new": {
"min_range_miles": 218,
"max_range_miles": 236
},
"expected_real_electric_range_now": {
"min_range_miles": 203,
"max_range_miles": 220
},
"battery_health_test_result": {
"is_record_available": true,
"test_date": "2024-01-10",
"test_result_grade": "A+",
"min_range_miles": 205,
"max_range_miles": 223
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_registration_mark
e.g. AB21ABC
Vehicle registration number (VRM).
current_mileage
e.g. 35000
Current mileage of the vehicle
manufacturer_desc
e.g. Jaguar
Manufacturer description
model_range_desc
e.g. I-Pace
Model range description
variant_desc
e.g. EV400
Variant description
manufactured_year
e.g. 2020
Year of manufacture.
battery_capacity_kwh
e.g. 90
Battery capacity in kwh
usable_battery_capacity_kwh
e.g. 84.7
The usable battery capacity in kwh
wltp_pure_electric_range_combined_miles_test_energy_low
e.g. 292
WLTP pure electric range combined miles test energy low
miles
e.g. 65000
The remaining battery warranty miles
months
e.g. 59
The remaining battery warranty months
min_range_miles
e.g. 218
The minimum range in miles
max_range_miles
e.g. 236
The maximum range in miles
min_range_miles
e.g. 203
The minimum range in miles
max_range_miles
e.g. 220
The maximum range in miles
is_record_available
e.g. true
The maximum range in miles
test_date
e.g. 2024-01-10
The battery test date
test_result_grade
e.g. A+
The battery test result grade
min_range_miles
e.g. 205
The minimum range in miles
max_range_miles
e.g. 223
The maximum range in miles
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