Battery level

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

Charging status

Know whether an electric vehicle's charging cable is plugged in and whether it is charging.

Start and stop charge (early access)

Remotely start or stop charging an electric vehicle.

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 battery level
const battery = await vehicle.battery();
console.log(battery);

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

// Start the vehicle's charging session
await vehicle.startCharge();

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

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

// Example response from Smartcar (start charge)
{
  "status": "success"
}