GET
/
v2.0
/
vehicles
/
{id}
/
battery
curl "https://api.smartcar.com/v2.0/vehicles/{id}/battery" \
    -H "Authorization: Bearer {token}" \
    -X "GET"
{
    "percentRemaining": 0.3,
    "range": 40.5
}

Permission

read_battery
The Vehicles API v2.0 will be deprecated by Q3 of 2026. We recommend migrating to the latest version as soon as possible to ensure continued support and access to new features.
This endpoint is only available for BEVs and PHEVs.

Request

Path
id
string
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"

Response

percentRemaining
number
The EV’s state of charge as a percentage.
range
number
default:"kilometers"
The estimated remaining distance the vehicle can travel powered by its high voltage battery.
{
    "percentRemaining": 0.3,
    "range": 40.5
}