APIs/Connected Vehicle API
APIs/Connected Vehicle API

Engine

Get engine status

Vehicle’s latest engine status value.

get

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

Scopes

  • openid

  • conve:engine_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}/engine-status' \
-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 engine

Command used to start the engine of the vehicle.

post

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

Scopes

  • openid

  • conve:engine_start_stop

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 runtimeMinutes. This is the time in minutes engine will be running. Is required for engine start and can maximum be set to 15 minutes.

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/engine-start' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.enginestart.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d '{\"runtimeMinutes\":10}'

Body

{
  "runtimeMinutes": 10
}

Stop engine

Command used to stop the engine of the vehicle.

post

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

Scopes

  • openid

  • conve:engine_start_stop

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

Engine/Get engine status