Climate
Get external temperature
Environment values such as external temperature collected by means of vehicle sensors.
get
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/environment
Scopes
openid
conve:environment
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 environment.
| Field | Description |
Field externalTemp.value | Description The external temperature read by the vehicle’s exterior temperature sensor. |
Field externalTemp.unit | Description Always celsius. |
Field externalTemp.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}/environment' \
-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>'Start climatisation
Breaking changes planned. This endpoint will be replaced in the next version.
Used to send a climatisation start command to the vehicle.
post
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/climatization-start
Scopes
openid
conve:climatization_start_stop
Headers
| Key | Description |
Key content-type | Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.climatizationstart.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.Request body
The request body data needed to perform the invocation command is NONE.
Response body
The response’s data node provides the details for the queried request.
| Field | Description |
Field status | Description Response status code. |
Field operationId | Description Id to log and track the request. |
Field async.status | Description Status of the request sent to the vehicle. Possible values: RUNNING, WAITING, COMPLETED, REJECTED, UNKNOWN, TIMEOUT, CONNECTION_FAILURE, VEHICLE_IN_SLEEP, UNLOCK_TIME_FRAME_PASSED, UNABLE_TO_LOCK_DOOR_OPEN. |
Field async.id | Description Request id. |
Field async.href | Description URL of the request to see the details and status of the command. |
Field async.expires | Description The expiry date for getting the details about the request. The invocation log is stored for one year. |
Examples
curl -v -X POST 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/climatization-start' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.climatizationstart.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''Stop climatisation
Breaking changes planned. This endpoint will be replaced in the next version.
Used to send a climatisation stop command to the vehicle.
post
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/climatization-stop
Scopes
openid
conve:climatization_start_stop
Headers
| Key | Description |
Key content-type | Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.climatizationstop.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.Request body
The request body data needed to perform the invocation command is NONE.
Response body
The response’s data node provides the details for the queried request.
| Field | Description |
Field status | Description Response status code. |
Field operationId | Description Id to log and track the request. |
Field async.status | Description Status of the request sent to the car. Possible values: RUNNING, WAITING, COMPLETED, REJECTED, UNKNOWN, TIMEOUT, CONNECTION_FAILURE, VEHICLE_IN_SLEEP, UNLOCK_TIME_FRAME_PASSED, UNABLE_TO_LOCK_DOOR_OPEN. |
Field async.id | Description Request id. |
Field async.href | Description URL of the request to see the details and status of the command. |
Field async.expires | Description The expiry date for getting the details about the request. The invocation log is stored for one year. |
Examples
curl -v -X POST 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/climatization-stop' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.climatizationstop.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''