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
| Key | Description |
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.
| Field | Description |
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
| Key | Description |
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.
| Field | Description |
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
| Key | Description |
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.
| Field | Description |
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>'