APIs/Connected Vehicle API
APIs/Connected Vehicle API
Fuel
Get fuel amount
Endpoint used to get vehicle’s latest fuel amount in liters.
get
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/fuel
Scopes
openid
conve:fuel_status
Headers
| Key | Description |
| Key accept | Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.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 fuel amount.
| Field | Description |
| Field fuelAmount.value | Description The latest retrieved remaining fuel-amount. |
| Field fuelAmount.unit | Description Always liters. |
| Field fuelAmount.timestamp | Description Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle. |
Examples
curl -v -X GET 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/fuel' \
-H 'accept: application/vnd.volvocars.api.connected-vehicle.vehicledata.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>'Get battery charge level
Endpoint used to get vehicle's latest battery charge level in percentage.
get
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/battery-charge-level
Scopes
openid
conve:fuel_status
Headers
| Key | Description |
| Key accept | Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.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 battery charge level.
| 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 has been last retrieved from the vehicle. |
Examples
curl -v -X GET 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/battery-charge-level' \
-H 'accept: application/vnd.volvocars.api.connected-vehicle.vehicledata.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>'