APIs/Connected Vehicle APIVersion 2

Fuel

Get fuel amount

Endpoint used to get vehicle’s latest fuel amount in litres and/or battery charge level. The data returned will differ dependent on whether the vehicle is using diesel/petrol, a battery, or both, to power engine of the vehicle.

get

https://api.volvocars.com/connected-vehicle/v2/vehicles/{vin}/fuel

Scopes

openid
conve:fuel_status
conve:battery_charge_level

Headers

Key	Description
Key accept	Description The mediatype of what should be returned. The valid values are: application/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 l.
Field fuelAmount.timestamp	Description Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.
Field batteryChargeLevel.value	Description The latest retrieved battery charge level in percent.
Field batteryChargeLevel.unit	Description Always %.
Field batteryChargeLevel.timestamp	Description Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Examples

curl -X GET 'https://api.volvocars.com/connected-vehicle/v2/vehicles/{vin}/fuel' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer <your-access-token>' \
  -H 'vcc-api-key: <your-vcc-api-key>'