Charge Status

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

charge = vehicle.charge()

const charge = await vehicle.charge()

VehicleCharge charge = vehicle.charge();

charge = vehicle.charge

{
    "isPluggedIn": true,
    "state": "FULLY_CHARGED"
}

GET

v2.0

vehicles

{id}

charge

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

charge = vehicle.charge()

const charge = await vehicle.charge()

VehicleCharge charge = vehicle.charge();

charge = vehicle.charge

{
    "isPluggedIn": true,
    "state": "FULLY_CHARGED"
}

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.

Permission

read_charge

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}/charge" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

charge = vehicle.charge()

const charge = await vehicle.charge()

VehicleCharge charge = vehicle.charge();

charge = vehicle.charge

Response

bool

Indicates whether a charging cable is currently plugged into the vehicle’s charge port.

string

Returns the current charge status of a vehicle. A vehicle can be FULLY_CHARGED at less than 100% SoC if its Charge Limit is less than 1.

Show states

{
    "isPluggedIn": true,
    "state": "FULLY_CHARGED"
}

Charge Limit Diagnostic Trouble Codes

⌘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