This version is deprecated and will be removed on April 30, 2024. Explore the latest version .

APIs/Connected Vehicle API
APIs/Connected Vehicle API

Diagnostics

Get engine diagnostic values

Endpoint used to get the vehicle’s latest engine diagnostic values. Diagnostics such as engine-coolant-level, oil level etc.

get

https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/engine

Scopes

  • openid

  • conve:diagnostics_engine_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 values fitting into the category of engine diagnostics.

FieldDescription

Field

engineRunning.value

Description

The latest retrieved engine-status value. Possible values: RUNNING, STOPPED.

Field

engineRunning.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

oilPressure.value

Description

The vehicle’s oil pressure value. Possible values: LOW, NORMAL, HIGH, LOWSOFT, LOWHARD, NOSENSOR, SYSTEMFAULT.

Field

oilPressure.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

engineCoolantLevel.value

Description

The vehicle’s latest coolant-level. Possible values: VERY_LOW, LOW, NORMAL, HIGH, VERY_HIGH.

Field

engineCoolantLevel.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

oilLevel.value

Description

Latest oil-level. Possible values: VERY_LOW, LOW, NORMAL, HIGH, VERY_HIGH.

Field

oilLevel.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

engineCoolantTemp.value

Description

Latest retrieved coolant-temperature.

Field

engineCoolantTemp.unit

Description

Always celsius.

Field

engineCoolantTemp.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/v1/vehicles/{vin}/engine' \
  -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 diagnostic values

Endpoint used to get the vehicle’s values grouped under diagnostic category.

get

https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/diagnostics

Scopes

  • openid

  • conve:diagnostics_workshop

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 provides the details for the queried vehicle data.

FieldDescription

Field

serviceWarningStatus.value

Description

Represents the service-status of the the vehicle. Possible values: NORMAL, ALMOST_TIME_FOR_SERVICE, TIME_FOR_SERVICE, TIME_EXCEEDED.

Field

serviceWarningStatus.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

serviceWarningTrigger.value

Description

The vehicle property triggering the service warning. Possible values: CALENDAR_TIME, ECM, DISTANCE, ENGINE_HOURS.

Field

serviceWarningTrigger.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

engineHoursToService.value

Description

The remaining engine-hours till the next scheduled service maintenance.

Field

engineHoursToService.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

kmToService.value

Description

The remaining kilometers till the next scheduled service maintenance.

Field

kmToService.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

monthsToService.value

Description

The remaining months till the next scheduled service maintenance.

Field

monthsToService.timestamp

Description

Timestamp in ISO-8601 format when the value has been last retrieved from the vehicle.

Field

washerFluidLevel.value

Description

The latest retrieved washer fluid level. Possible values: VERY_LOW, LOW NORMAL, HIGH, VERY_HIGH.

Field

washerFluidLevel.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/v1/vehicles/{vin}/diagnostics' \
  -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 brake fluid level

Endpoint used to get the vehicle’s current brake fluid level.

get

https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/brakes

Scopes

  • openid

  • conve:brake_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 provides the details for the queried vehicle data.

FieldDescription

Field

brakeFluid.value

Description

Latest read brake fluid level. Possible values: VERY_LOW, LOW NORMAL, HIGH, VERY_HIGH.

Field

brakeFluid.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/v1/vehicles/{vin}/brakes' \
  -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>'