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
| Key | Description |
| 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.
| Field | Description |
| 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 -v -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
| Key | Description |
| 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.
| Field | Description |
| Field serviceStatus.value | Description Represents the service-status of the the vehicle. Possible values: NORMAL, ALMOST_TIME_FOR_SERVICE, TIME_FOR_SERVICE, TIME_EXCEEDED. |
| Field serviceStatus.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, ECM, DISTANCE, ENGINE_HOURS. |
| Field serviceTrigger.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 -v -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
| Key | Description |
| 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.
| Field | Description |
| 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 -v -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>'