APIs/Connected Vehicle APIVersion 2
APIs/Connected Vehicle APIVersion 2

Warnings

Get warnings

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

get

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

Scopes

  • openid

  • conve:warnings

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.

In this table we talk about classic cars. What we mean are cars without Android-based infotainment system. Google, Android, and other Google trademarks, are property of Google LLC.

FieldDescription

Field

brakeLightLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

brakeLightLeftWarning.timestamp

Description

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

Field

brakeLightCenterWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

brakeLightCenterWarning.timestamp

Description

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

Field

brakeLightRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

brakeLightRightWarning.timestamp

Description

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

Field

fogLightFrontWarning.value

Description

Classic cars will populate fogLightFrontWarning if any of the front fog lights are failed/not failed. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

fogLightFrontWarning.timestamp

Description

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

Field

fogLightRearWarning.value

Description

Classic cars will populate fogLightRearWarning if any of the rear fog lights are failed/not failed. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

fogLightRearWarning.timestamp

Description

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

Field

positionLightFrontLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

positionLightFrontLeftWarning.timestamp

Description

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

Field

positionLightFrontRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

positionLightFrontRightWarning.timestamp

Description

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

Field

positionLightRearLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

positionLightRearLeftWarning.timestamp

Description

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

Field

positionLightRearRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

positionLightRearRightWarning.timestamp

Description

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

Field

highBeamLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

highBeamLeftWarning.timestamp

Description

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

Field

highBeamRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

highBeamRightWarning.timestamp

Description

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

Field

lowBeamLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

lowBeamLeftWarning.timestamp

Description

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

Field

lowBeamRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

lowBeamRightWarning.timestamp

Description

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

Field

daytimeRunningLightLeftWarning.value

Description

Classic cars will populate both daytimeRunningLight statuses if any of the two front daytime running lights are failed/not failed. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

daytimeRunningLightLeftWarning.timestamp

Description

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

Field

daytimeRunningLightRightWarning.value

Description

Classic cars will populate both daytimeRunningLight statuses if any of the two front daytime running lights are failed/not failed. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

daytimeRunningLightRightWarning.timestamp

Description

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

Field

turnIndicationFrontLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

turnIndicationFrontLeftWarning.timestamp

Description

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

Field

turnIndicationFrontRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

turnIndicationFrontRightWarning.timestamp

Description

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

Field

turnIndicationRearLeftWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

turnIndicationRearLeftWarning.timestamp

Description

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

Field

turnIndicationRearRightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

turnIndicationRearRightWarning.timestamp

Description

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

Field

registrationPlateLightWarning.value

Description

Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

registrationPlateLightWarning.timestamp

Description

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

Field

sideMarkLightsWarning.value

Description

Not available for Classic cars. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

sideMarkLightsWarning.timestamp

Description

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

Field

hazardLightsWarning.value

Description

Classic cars specific status. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

hazardLightsWarning.timestamp

Description

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

Field

reverseLightsWarning.value

Description

Classic cars specific status. Possible values: UNSPECIFIED, NO_WARNING, FAILURE.

Field

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

/