EV Battery API

Click, consent, retrieve SoC.

Read an electric vehicle’s battery level and battery capacity with simple API requests.

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).

Battery capacity

Know the capacity of an electric vehicle’s battery.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
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 battery capacity 
const batteryCapacity = await vehicle.batteryCapacity();
console.log(batteryCapacity);
// Example response from Smartcar (battery level)
{
  "percentRemaining": 0.3,
  "range": 40.5,
}

// Example response from Smartcar (battery capacity)
{
  "capacity": 28.7,
}
See the API docs

Product features

Compatible with 20 car brands

Compatible with 20 car brands

Friendly user consent flow

Friendly user consent flow

Works on 2015 and newer vehicles

Works on 2015 and newer vehicles

Trusted & secure

Trusted & secure

Access to live car data

Access to live car data

SDKs for Go, Java, Node.js, Python, and Ruby

SDKs for Go, Java, Node.js, Python, and Ruby

Learn more about Smartcar’s APIs

Related industries

EV charging networks

Provide estimated charging times, automatic charging schedules, and EV trip planning in your app.

Learn more about EV charging

Energy & utility providers

Manage your customers’ residential EV charging to best balance electric grid load.

Learn more about energy and utilities

What we’re building

Latency and frequency of data availability may vary between makes and models.