Battery Level

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
}

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 by Q4 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

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"

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
}

Battery Capacity Charge Limit

⌘I

Introduction

Authorization

Connections

Webhooks

Vehicle Data

Vehicle Commands

Compatibility

API 2.0 Reference (Legacy)

Vehicle Commands (Legacy)

Management API (Legacy)

Compatibility API (Legacy)

Permission

Request

Response

​Permission

​Request

​Response

Permission

Request

Response