APIs/Extended Vehicle API
APIs/Extended Vehicle API

Endpoints

List vehicles

Provides all current valid relations between a Volvo ID (users account) and its connected vehicles.

get

https://api.volvocars.com/extended-vehicle/v1/vehicles

Scopes

  • openid

  • vehicle:attributes

Headers

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

Response body

Returns a list of VIN numbers together with timestamp of relation.

FieldDescription

Examples

curl -X GET 'https://api.volvocars.com/extended-vehicle/v1/vehicles' \
-H 'accept: application/json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>'

List vehicle resources

After receiving which vehicles are connected to the end-user, you can use the resources endpoint with an id from the previous request in order to find out which resources are available for read out on the vehicle.

get

https://api.volvocars.com/extended-vehicle/v1/vehicles/{vin}/resources

Scopes

  • openid

  • vehicle:attributes

Headers

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

Response body

FieldDescription

Examples

curl -X GET 'https://api.volvocars.com/extended-vehicle/v1/vehicles/{vin}/resources' \
-H 'accept: application/json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>'

Get resource value

After identifying which resources are available for readout you can request information about an individual resource and its value.

get

https://api.volvocars.com/extended-vehicle/v1/vehicles/{vin}/resources/{resource}

Headers

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

Response body

Regardless of which resource is being requested to get information about a successfull response body will contain the following fields:

FieldDescription
In order to retrieve the values for a resource the end-user needs to have given consent for the specific resource values to be retrieved. Otherwise the request will fail.

Example

Here is an example of how to retrieve the resource engineCoolantTemp from the vehicle.

curl -X GET 'https://api.volvocars.com/extended-vehicle/v1/vehicles/{vin}/resources/engineCoolantTemp' \
-H 'accept: application/json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>'

Endpoints/List vehicles