Skip to main content
GET
/
v2.0
/
vehicles
/
{id}
/
{make}
/
battery
curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"

{
    "heaterOn": null,
    "maxRangeChargeCounter" : null,
    "notEnoughPowerToHeat" : true, 
    "percentRemaining": 0.3,
    "percentRemainingUsable" : 0.29,
    "range": 40.5,
    "rangeEstimated": 39.01,
    "rangeIdeal" : 40.5
}

Documentation Index

Fetch the complete documentation index at: https://smartcar.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is currently available for tesla
The following fields are not supported for streaming vehicles:
  • TeslaBatteryPercentRemainingUsable
  • TeslaBatteryMaxRangeChargeCounter

​
Permission

read_battery 
curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/battery" \
-H "Authorization: Bearer {token}" \
-X "GET"

​
Request

Path
​
id
string
required
The vehicle ID of the vehicle you are making a request to.
​
make
string
required
The make of the vehicle you are making a request to.

​
Response

​
percentRemaining
number | null
The EV’s state of charge as a percentage.
​
range
number | null
The distance the vehicle can travel powered by it’s high voltage battery.
​
heaterOn
bool | null
Indicates if the battery heater is on.
​
rangeEstimated
number | null
The estimated remaining distance the vehicle can travel powered by it’s high voltage battery as determined by Tesla.
​
rangeIdeal
number | null
The ideal remaining distance the vehicle can travel powered by it’s high voltage battery as determined by Tesla.
​
percentRemainingUsable
number | null
The EV’s useable state of charge as a percentage as reported by Tesla.
​
maxRangeChargeCounter
number | null
The number of times the vehicle has been charged to 100% as reported by Tesla.
​
notEnoughPowerToHeat
bool | null
Indicates if there is enough power to heat the battery.
{
    "heaterOn": null,
    "maxRangeChargeCounter" : null,
    "notEnoughPowerToHeat" : true, 
    "percentRemaining": 0.3,
    "percentRemainingUsable" : 0.29,
    "range": 40.5,
    "rangeEstimated": 39.01,
    "rangeIdeal" : 40.5
}