UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Predicted Range from VRM

Powered by ClearWatt

Supercharge your used EV marketing and increase buyer confidence.

 

This unique data will add value to your adverts, help you stand out from the competition and maximise the retail opportunity for electric vehicles as used vehicle supply increases.   

 

ClearWatt has used data from thousands of battery health tests to provide realistic range expectations based on vehicle age and mileage, compared to benchmark real range when new.

 

The service also includes valuable information on the remaining battery warranty to help improve buyer confidence.

 

Key features:

 

  • VRM lookup

  • Remaining battery warranty (months, miles)

  • Benchmark real electric range when new

  • Expected real electric range now, based on age and mileage

  • Actual test data (if the vehicle has recently been tested)

 

Pricing

PAYG
£1.50
Per Use
Business
£1.25
Per Use
Enterprise
£1.00
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)£1.50€1.80$2.10
Business (Per Use)£1.25€1.50$1.75
Enterprise (Per Use)£1.00€1.20$1.40

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://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/clearwatt/expectedrangefromvrm?vehicle_registration_mark=AB21ABC&current_mileage=12345

Example Sandbox Request

https://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/clearwatt/expectedrangefromvrm?vehicle_registration_mark=AB21ABC&current_mileage=12345&sandbox=1

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

Also Available From ClearWatt