UK-EN

ClearWatt API

Used EV Range Estimates & Battery Warranty Data

Sign up for a FREE API account

One Auto API provides access to ClearWatt's real world used EV range estimated through a single API, alongside data from other vehicle-data providers.

About ClearWatt

ClearWatt helps bring greater transparency to the used electric vehicle market. Its battery health testing and real-world performance data give dealers a stronger evidential basis for explaining what an EV is likely to deliver on the road. For buyers, that means a clearer answer to one of the most important questions in any used EV purchase: how far can this particular vehicle realistically travel?

Through One Auto API, dealers and automotive platforms can access ClearWatt’s used EV range estimate by vehicle registration and current mileage. The service compares the vehicle’s estimated real-world range when new with its expected real-world range now, taking account of its age and mileage. It also provides information about the remaining battery warranty. If ClearWatt has tested the individual vehicle, the response can include its recorded battery health result and the date of testing.

Why official range figures need context

Official range figures are useful for comparing vehicles under standardised test conditions. They are less useful when presented as a promise of what a customer will achieve in everyday driving. An older EV may have an NEDC figure produced under a test regime that can be particularly far removed from real-world use. WLTP offers a different standardised comparison, but its figure can still differ from the range a driver experiences.

That difference matters even before the vehicle has aged. Weather, driving speed, terrain, heating and air conditioning all affect the distance available from a charge. With a used EV, changes in battery capacity over time add another consideration. Displaying only the original official range can therefore leave a buyer with an expectation the vehicle cannot meet in their circumstances.

For dealers, the consequences go beyond a disappointed test drive. If marketing materials appear to overstate a used EV’s range, customers may raise complaints or seek to return the vehicle. Clearer information at the point of sale helps dealers explain the car fairly and helps buyers decide whether it suits their journeys.

A more useful range comparison

ClearWatt provides a benchmark for real-world range when the vehicle was new, followed by an estimate of its real-world range at its current age and mileage. Presenting both figures helps customers understand two separate effects: the gap between an official laboratory figure and everyday performance, and the further change that may occur as an individual vehicle gets older.

The current range figure is an estimate based on thousands of tests, rather than a direct measurement of an untested vehicle’s battery. It gives dealers a practical starting point for a listing or sales conversation and for cusrtomers a realistic benchmark of what to expect from a used EV. Where a vehicle has been tested using ClearWatt’s app, its recorded result adds evidence specific to that car. Showing the test date alongside the result makes clear when that assessment was made.

ClearWatt’s battery health approach draws on information gathered from vehicles and real-world EV performance insights. This helps put range estimates into a more meaningful context than a single headline figure. The remaining battery warranty information gives buyers another useful point to consider when assessing a used EV.

Help customers choose the right used EV

Range expectations differ from one buyer to another. A customer who charges at home and makes short local trips may be comfortable with a vehicle that would not suit someone regularly driving long motorway routes. By discussing a realistic range estimate early, dealers can connect the vehicle’s capabilities to the customer’s expected use.

That conversation begins online. A dealer can enrich an EV listing with the estimated real-world range when new and now, rather than relying solely on its original NEDC or WLTP figure. In the showroom, the same information can support a more informed discussion about journey length, charging opportunities and the vehicle’s remaining battery warranty. Where a ClearWatt test result is available, the dealer can share that additional evidence for the specific vehicle.

This approach supports confident marketing without treating an estimate as a guaranteed range. It gives customers the information to shortlist suitable cars and helps sales teams answer questions consistently. Setting realistic expectations before purchase can reduce avoidable misunderstandings after handover.

Access ClearWatt data through One Auto API

The ClearWatt Used EV Range Estimate is available through One Auto API. A registration and current mileage request returns the vehicle’s range comparison, remaining battery warranty information and any available ClearWatt test record. Dealers can incorporate that data into stock listings, appraisal tools and customer journeys alongside other vehicle information available through our platform.

The result is a better-informed purchase decision, with customer expectations grounded in the vehicle’s likely real-world performance.

What the API Includes

Field NameField TypeExampleDefinition
battery_capacity_kwh
Float
99.5Battery capacity in kwh
current_mileage
Int
12345Current mileage of the vehicle
error
String
Example error detailsDetails of what went wrong with the api call
is_record_available
Boolean
trueThe maximum range in miles
manufactured_year
Int
2020Year of manufacture.
manufacturer_desc
String
MiniManufacturer description
max_range_miles
Int
236The maximum range in miles
miles
Int
65000The remaining battery warranty miles
min_range_miles
Int
218The minimum range in miles
model_range_desc
String
HatchModel range description.
months
Int
59The remaining battery warranty months
result
String
failHas the vehicle passed all lead validation tests.
success
Boolean
trueWhether the api call was successful
test_date
Date
2024-01-10The battery test date
test_result_grade
String
A+The battery test result grade
usable_battery_capacity_kwh
Float
84.7The usable battery capacity in kwh
variant_desc
String
5 door autoVariant description
vehicle_registration_mark
String
Vehicle registration number (VRM).
wltp_pure_electric_range_combined_miles_test_energy_low
Float
292WLTP pure electric range combined miles test energy low

Sample ClearWatt API Response

Used EV Range Estimate
{
  "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"
}

FAQ

Yes. ClearWatt's used-EV range estimate and remaining battery warranty data is available via One Auto API, based on independent testing of thousands of used electric vehicles. Input VRM and mileage to boost buyer confidence when viewing used-EV listings.

Real-world EV range expectations, plus remaining battery warranty - derived from independent battery-health testing. Designed to enhance used-EV adverts and boost buyer confidence, delivered alongside data from other leading data providers.

ClearWatt gives realistic used-EV range from independent testing of real vehicles, adding real-world context alongside manufacturer figures for used stock.

Enrich used-EV adverts, stock locators and valuation tools with expected range and remaining battery warranty to increase buyer confidence and sell used EVs faster.

Yes. Combine ClearWatt estimated used-EV range data with valuations, specification and provenance data to deliver a rich user experience when generating used-EV listings for faster sales.

Is there an API for ClearWatt's used-EV range estimates?

Yes. ClearWatt's used-EV range estimate and remaining battery warranty data is available via One Auto API, based on independent testing of thousands of used electric vehicles. Input VRM and mileage to boost buyer confidence when viewing used-EV listings.

What used-EV range data does the ClearWatt API return?

Real-world EV range expectations, plus remaining battery warranty - derived from independent battery-health testing. Designed to enhance used-EV adverts and boost buyer confidence, delivered alongside data from other leading data providers.

How does ClearWatt range data complement official WLTP range figures?

ClearWatt gives realistic used-EV range from independent testing of real vehicles, adding real-world context alongside manufacturer figures for used stock.

How can dealers, auctions and used car marketplaces use ClearWatt data via API?

Enrich used-EV adverts, stock locators and valuation tools with expected range and remaining battery warranty to increase buyer confidence and sell used EVs faster.

Can I combine ClearWatt data with other sources of EV data via One Auto API?

Yes. Combine ClearWatt estimated used-EV range data with valuations, specification and provenance data to deliver a rich user experience when generating used-EV listings for faster sales.

Sign Up for a FREE API Account

Get instant access to our sandbox API and start building today.

No credit card required. Get started in minutes.

Data Providers:

Auto TraderAutoPredictBregoCarketaCartellCazanaClearWattDriveRightDataEV DatabaseEVOX ImagesExperianEzyvinMarketcheckRecall HQSagacitySalvageGuideSolifi Vehicle DataVIN AuditVehicle Data GlobalVehicle Imagery

Categories:

Car ImagesCar Mileage ChecksCar SpecificationElectric Vehicle DataLicense Plate to VINOE VIN LookupRegistration (VRM) LookupSMR DataService HistoryVIN DecoderVehicle Build SheetVehicle DataVehicle History ChecksVehicle Recall ChecksVehicle Technical DataVehicle Valuations

Solutions:

Aftermarket & PartsAuction & RemarketingAutomotive Data ReportsCar Buying PlatformsConsultancy ServicesConsumer Websites & AppsData CleansingData ProvidersFinance BrokersFleet OperatorsFranchised DealersIndependent DealersLead ManagementLeasing & Fleet ManagementLeasing BrokersManufacturersMotor FinanceMotor InsuranceRetail Pricing StrategiesScrap & SalvageSoftware DevelopersVehicle Appraisal SoftwareVehicle AssessorsVehicle History ReportsWhole Life Costs

Company:

About usBlogContact UsKnowledge BasePrivacy PolicyTerms and Conditions

Coverage:

CanadaEuropeIrelandUnited KingdomUnited States