APIs/Connected Vehicle APIVersion 1
APIs/Connected Vehicle APIVersion 1

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

KeyDescription

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.

FieldDescription

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

KeyDescription

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.

FieldDescription

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>'

Fuel/Get fuel amount