APIs/Energy APIVersion 1

Electric range

Get electric range

Endpoint used to get vehicle's latest electric range in kilometers.

get

https://api.volvocars.com/energy/v1/vehicles/{vin}/recharge-status/electric-range

Scopes

openid
energy:electric_range

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 lists the vehicle’s latest estimated distance to empty in kilometers while parked.

Field	Description
Field electricRange.value	Description The latest retrieved range.
Field electricRange.unit	Description Always kilometers.
Field electricRange.timestamp	Description Timestamp based on system UTC clock when the value has been last retrieved from the vehicle.

Examples

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