APIs/Connected Vehicle API
APIs/Connected Vehicle API

Doors, windows and locks

Get window status

Endpoint used to get vehicle’s latest window status values.

get

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

Scopes

  • openid

  • conve:windows_status

Headers

KeyDescription
All these header values are mandatory. They must exist in every request.

Response body

The response’s data node lists the vehicle’s latest window status values.

FieldDescription

Examples

curl -v -X GET 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/windows' \
-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 door and lock status

Vehicle’s door and lock status values.

get

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

Scopes

  • openid

  • conve:doors_status

  • conve:lock_status

Headers

KeyDescription
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

Examples

curl -v -X GET 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/doors' \
-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>'

Lock doors

Command used to lock the vehicle’s doors.

post

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

Scopes

  • openid

  • conve:lock

Headers

KeyDescription
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.

FieldDescription

Examples

curl -v -X POST 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/lock' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.lock.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''

Unlock doors

Command used to unlock the vehicle’s trunk/boot doors. When opening a trunk/boot door in a certain unlock duration time the other doors will be opened as well.

post

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

Scopes

  • openid

  • conve:unlock

Headers

KeyDescription
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 unlockDuration. This it the time in seconds that the trunk/boot door can be unlocked. After that time the trunk/boot door will not be able to open. Can maximum be set to 120 seconds.

Response body

The response’s data node provides the details for the queried request.

FieldDescription

Examples

curl -v -X POST 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/unlock' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.unlock.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d '{\"unlockDuration\":120}'

Body

{
  "unlockDuration": 120
}

Doors, windows and locks/Get window status