APIs/Energy APIVersion 1

Battery charge level

Get battery charge level

Provides the latest retrieved battery charge level, also known as the state of charge (SoC), for a specific vehicle. The battery charge level is represented as a percentage, with 100% indicating a fully charged battery, and 0% indicating a completely depleted battery.

get

https://api.volvocars.com/energy/v1/vehicles/{vin}/recharge-status/battery-charge-level

Scopes

openid
energy:battery_charge_level

Headers

Key	Description
Key accept	Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.energy.vehicledata.v1+json
Key authorization	Description The access token issued by Volvo ID identity system.
Key vcc-api-key	Description Your application’s VCC API Key.

All these header values are mandatory. They must exist in every request.

Response body

The response’s data node contains the vehicle’s latest battery charge level in percentage.

Field	Description
Field batteryChargeLevel.value	Description The latest retrieved battery charge level.
Field batteryChargeLevel.unit	Description Always percentage.
Field batteryChargeLevel.timestamp	Description Timestamp in ISO-8601 format when the value was last retrieved from the vehicle.

Examples

curl -X GET 'https://api.volvocars.com/energy/v1/vehicles/{vin}/recharge-status/battery-charge-level' \
  -H 'accept: application/vnd.volvocars.api.energy.vehicledata.v1+json' \
  -H 'authorization: Bearer <your-access-token>' \
  -H 'vcc-api-key: <your-vcc-api-key>'