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

APIs/Connected Vehicle API
APIs/Connected Vehicle API

Warnings

Get warnings

Used to get the vehicle data grouped under warning category such as bulb failure.

get

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

Scopes

  • openid

  • conve:warnings

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

bulbFailure.value

Description

Represents which bulb(s) may have failure. Possible values: LEFT_TURN_ANY, RIGHT_TURN_ANY, LOW_BEAM_ANY, LOW_BEAM_LEFT, LOW_BEAM_RIGHT, HIGH_BEAM_ANY, HIGH_BEAM_LEFT, HIGH_BEAM_RIGHT, FOG_FRONT_ANY, FOG_REAR_ANY, STOP_ANY, POSITION_ANY, DAY_RUNNING_ANY, TRAILER_TURN_ANY, TRAILER_TURN_LEFT_ANY, TRAILER_TURN_RIGHT_ANY, TRAILER_STOP_ANY, TRAILER_ELECTRICAL_FAILURE, MULTIPLE.

Field

bulbFailure.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}/warnings' \
  -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>'