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/v2/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/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

engineCoolantLevelWarning.timestamp

Description

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

Field

engineCoolantLevelWarning.value

Description

Engine coolant level warning status. Possible values: UNSPECIFIED, NO_WARNING, TOO_LOW.

Field

oilLevelWarning.value

Description

Oil level warning status. Possible values: UNSPECIFIED, NO_WARNING, SERVICE_REQUIRED, TOO_LOW, TOO_HIGH.

Field

oilLevelWarning.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}/engine' \
  -H 'accept: application/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/v2/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/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

serviceWarning.timestamp

Description

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

Field

serviceWarning.value

Description

Service warning status. Possible values: UNSPECIFIED, NO_WARNING, UNKNOWN_WARNING, REGULAR_MAINTENANCE_ALMOST_TIME_FOR_SERVICE, ENGINE_HOURS_ALMOST_TIME_FOR_SERVICE, DISTANCE_DRIVEN_ALMOST_TIME_FOR_SERVICE, REGULAR_MAINTENANCE_TIME_FOR_SERVICE, ENGINE_HOURS_TIME_FOR_SERVICE, DISTANCE_DRIVEN_TIME_FOR_SERVICE, REGULAR_MAINTENANCE_OVERDUE_FOR_SERVICE, ENGINE_HOURS_OVERDUE_FOR_SERVICE, DISTANCE_DRIVEN_OVERDUE_FOR_SERVICE.

Field

serviceTrigger.timestamp

Description

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

Field

serviceTrigger.value

Description

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

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

distanceToServiceKm.value

Description

The remaining kilometers till the next scheduled service maintenance.

Field

distanceToServiceKm.timestamp

Description

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

Field

timeToService.value

Description

The remaining time (days or month, see unit) till the next scheduled service maintenance.

Field

timeToService.timestamp

Description

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

Field

timeToService.unit

Description

Unit of the remaining time until next service. Possible values: days or months.

Examples

curl -X GET 'https://api.volvocars.com/connected-vehicle/v2/vehicles/{vin}/diagnostics' \
  -H 'accept: application/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/v2/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/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

brakeFluidLevelWarning.value

Description

Brake fluid level warning. Possible values: UNSPECIFIED, NO_WARNING, TOO_LOW.

Field

brakeFluidLevelWarning.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}/brakes' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer <your-access-token>' \
  -H 'vcc-api-key: <your-vcc-api-key>'

/