APIs/Connected Vehicle APIVersion 2
APIs/Connected Vehicle APIVersion 2

Lights and sound

Flash exterior lights

Used to send a flash command to the vehicle. The vehicles turn signals will flash. To check if a vehicle supports this function please call List commands.

post

https://api.volvocars.com/connected-vehicle/v2/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/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

vin

Description

Vehicle identification number

Field

statusCode

Description

Response status code.

Field

invokeStatus

Description

Invoke status of the request sent to the vehicle. Possible values: COMPLETED, REJECTED, UNKNOWN, TIMEOUT, CONNECTION_FAILURE, VEHICLE_IN_SLEEP, DELIVERED, CAR_ERROR, NOT_ALLOWED_PRIVACY_ENABLED, NOT_ALLOWED_WRONG_USAGE_MODE.

Field

message

Description

Extra information from the response.

Examples

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

Honk horn

Used to send a honk command to the vehicle. To check if a vehicle supports this function please call List commands.

post

https://api.volvocars.com/connected-vehicle/v2/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/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

vin

Description

Vehicle identification number

Field

statusCode

Description

Response status code.

Field

invokeStatus

Description

Invoke status of the request sent to the vehicle. Possible values: COMPLETED, REJECTED, UNKNOWN, TIMEOUT, CONNECTION_FAILURE, VEHICLE_IN_SLEEP, DELIVERED, CAR_ERROR, NOT_ALLOWED_PRIVACY_ENABLED, NOT_ALLOWED_WRONG_USAGE_MODE.

Field

message

Description

Extra information from the response.

Examples

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

Honk and flash

Used to send a honk and flash command to the vehicle. To check if a vehicle supports this function please call List commands.

post

https://api.volvocars.com/connected-vehicle/v2/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/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

vin

Description

Vehicle identification number

Field

statusCode

Description

Response status code.

Field

invokeStatus

Description

Invoke status of the request sent to the vehicle. Possible values: COMPLETED, REJECTED, UNKNOWN, TIMEOUT, CONNECTION_FAILURE, VEHICLE_IN_SLEEP, DELIVERED, CAR_ERROR, NOT_ALLOWED_PRIVACY_ENABLED, NOT_ALLOWED_WRONG_USAGE_MODE.

Field

message

Description

Extra information from the response.

Examples

curl -X POST 'https://api.volvocars.com/connected-vehicle/v2/vehicles/{vin}/commands/honk-flash' \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer <your-access-token>' \
  -H 'vcc-api-key: <your-vcc-api-key>'

/