APIs/Energy APIVersion 1

Target battery charge level

Get target battery charge level

Provides the latest retrieved target battery charge level for a specific vehicle. It indicates the desired state of charge that the vehicle should aim to achieve during a charging session. The target battery charge level is represented as a percentage (%). The car will not charge beyond this level.

This endpoint is not supported for the EX30 model

get

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

Scopes

openid
energy:target_battery_level

Headers

Key	Description
Key accept	Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.energy.targetbatterychargelevelresponse.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 target battery charge level in percentage.

Field	Description
Field targetBatteryChargeLevel.value	Description The retrieved target battery charge level.
Field targetBatteryChargeLevel.unit	Description Always percentage.
Field targetBatteryChargeLevel.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/target-battery-charge-level' \
  -H 'accept: application/vnd.volvocars.api.energy.targetbatterychargelevelresponse.v1+json' \
  -H 'authorization: Bearer <your-access-token>' \
  -H 'vcc-api-key: <your-vcc-api-key>'