Percent remaining

Retrieve the state of charge (SOC) from a battery electric vehicle (BEV) or a plug-in hybrid vehicle (PHEV).

Range

Access the estimated distance an EV can travel with its current battery level.

Plugged in

Know whether an EV’s charging cable is plugged in.

State

Know whether an EV is currently charging.

Node

const smartcar = require('smartcar');

// Get all vehicles associated with this access token
const {vehicles} = await smartcar.getVehicleIds("<access-token>");

// Construct a new vehicle instance using the first vehicle's id
const vehicle = new smartcar.Vehicle(vehicles[0], "<access-token>");

// Fetch the vehicle's EV battery level
const battery = await vehicle.battery();
console.log(battery);

// Fetch the vehicle's charging status
const charge = await vehicle.charge();
console.log(charge);

// Example response from Smartcar (EV battery level)
{
  "percentRemaining": 0.3,
  "range": 40.5,
}

// Example response from Smartcar (charging status)
{
  "isPluggedIn": true,
  "state":"FULLY_CHARGED"
}