Electric Vehicles
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
Permission
read_battery
This endpoint is only available for BEVs and PHEVs.
Request
Path
idrequired
string
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"
Response
percentRemaining
number
The EV’s state of charge in percent.
range
Default: "kilometers"number
The estimated remaining distance the vehicle can travel powered by it’s high voltage battery.
{
"percentRemaining": 0.3,
"range": 40.5
}
curl "https://api.smartcar.com/v2.0/vehicles/{id}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"
{
"percentRemaining": 0.3,
"range": 40.5
}