APIs/Energy APIVersion 1
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. |
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>'