APIs/Connected Vehicle API
APIs/Connected Vehicle API

Lights and sound

Flash exterior lights

Breaking changes planned. This endpoint will be replaced in the next version.

Used to send a flash command to the vehicle. The vehicles turn signals will flash.

post

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

Scopes

  • openid

  • conve:honk_flash

Headers

KeyDescription
Key
content-type
Description
The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.flash.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.

FieldDescription
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/flash' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.flash.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''

Honk horn

Breaking changes planned. This endpoint will be replaced in the next version.

Used to send a honk command to the vehicle.

post

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

Scopes

  • openid

  • conve:honk_flash

Headers

KeyDescription
Key
content-type
Description
The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.honk.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.

FieldDescription
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/honk' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.honk.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''

Honk and flash

Breaking changes planned. This endpoint will be replaced in the next version.

Used to send a honk and flash command to the vehicle.

post

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

Scopes

  • openid

  • conve:honk_flash

Headers

KeyDescription
Key
content-type
Description
The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.honkandflash.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.

FieldDescription
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/honk-flash' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.honkandflash.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d ''

Lights and sound/Flash exterior lights