curl "https://api.smartcar.com/v2.0/vehicles/{id}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"
battery = vehicle.battery()
const battery = await vehicle.battery();
VehicleBattery battery = vehicle.battery();
battery = vehicle.battery
{
"percentRemaining": 0.3,
"range": 40.5
}
Vehicle Data
Battery Level
Returns the state of charge and the remaining range of an electric vehicle’s high voltage battery.
GET
/
v2.0
/
vehicles
/
{id}
/
battery
curl "https://api.smartcar.com/v2.0/vehicles/{id}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"
battery = vehicle.battery()
const battery = await vehicle.battery();
VehicleBattery battery = vehicle.battery();
battery = vehicle.battery
{
"percentRemaining": 0.3,
"range": 40.5
}
Permission
read_battery
The Vehicles API v2.0 will be deprecated on December 1, 2026. The latest version, v3, was introduced on August 26, 2025. We recommend migrating as soon as possible to ensure continued support and access to new features.
This endpoint is only available for BEVs and PHEVs.
Request
Pathstring
required
The vehicle ID of the vehicle you are making a request to.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"
battery = vehicle.battery()
const battery = await vehicle.battery();
VehicleBattery battery = vehicle.battery();
battery = vehicle.battery
Response
number
The EV’s state of charge as a percentage.
number
default:"kilometers"
The estimated remaining distance the vehicle can travel powered by its high voltage battery.
{
"percentRemaining": 0.3,
"range": 40.5
}
Was this page helpful?