APIs/Extended Vehicle APIVersion 1
APIs/Extended Vehicle APIVersion 1

Resources

Average fuel consumption

Vehicle status service for average fuel consumption status.

resource

averageFuelConsumption

Scopes

  • openid

  • exve:fuel_status

Response body

Value

Double - average fuel consumption in liters per 100 kilometers

Unit

liters per 100 kilometers

Examples

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

Average speed

Vehicle status service for average speed status.

resource

averageSpeed

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Unit

kilometers per hour

Value

Integer - average speed in kilometers per hour

Examples

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

Backup battery remaining

Vehicle status service for backup battery remaining status.

Resource

backupBatteryRemaining

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Values

MINUTES_0
MINUTES_5
MINUTES_20
MINUTES_ABOVE_30
MINUTES_10
MINUTES_15
MINUTES_25

Examples

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

Brake fluid

Vehicle status service for brake fluid status.

Resource

brakeFluid

Scopes

  • openid

  • exve:brake_status

Response body

Values

VERY_LOW
LOW
NORMAL
HIGH
VERY_HIGH

Examples

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

Bulb failure

Vehicle status service for bulb failure status.

Resource

bulbFailure

Scopes

  • openid

  • exve:warnings

Response body

Values

LEFT_TURN_ANY
RIGHT_TURN_ANY
LOW_BEAM_ANY
LOW_BEAM_LEFT
LOW_BEAM_RIGHT
HIGH_BEAM_ANY
HIGH_BEAM_LEFT
HIGH_BEAM_RIGHT
FOG_FRONT_ANY
FOG_REAR_ANY
STOP_ANY
POSITION_ANY
DAY_RUNNING_ANY
TRAILER_TURN_ANY
TRAILER_TURN_LEFT_ANY
TRAILER_TURN_RIGHT_ANY
TRAILER_STOP_ANY
TRAILER_ELECTRICAL_FAILURE
MULTIPLE

Examples

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

Cab open

Service for retrieving if the cab is open or closed.

Resource

cabOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Car locked

Vehicle status service for view car locked status.

Resource

carLocked

Scopes

  • openid

  • exve:lock_status

Response body

Values

true : locked
false : open

Examples

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

Distance to empty

Vehicle status service for distance to empty status.

Resource

distanceToEmpty

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Unit

kilometers

Value

Integer - distanceToEmpty in kilometers

Examples

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

Engine coolant level

Vehicle status service for engine coolant level status.

Resource

engineCoolantLevel

Scopes

  • openid

  • exve:diagnostics_engine_status

Response body

Values

VERY_LOW
LOW
NORMAL
HIGH
VERY_HIGH

Examples

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

Engine coolant temperature

Vehicle status service for engine coolant temperature status.

Resource

engineCoolantTemp

Scopes

  • openid

  • exve:diagnostics_engine_status

Response body

Unit

celsius

Value

Integer - temperature in celsius

Examples

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>'

Engine hours to service

Vehicle status service for engine hours to service status.

Resource

engineHoursToService

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Unit

hours

Value

Integer - number of hours

Examples

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

Engine running

Vehicle status service for checking if the engine is running or not.

Resource

engineRunning

Scopes

  • openid

  • exve:engine_status

Response body

Values

true : running
false : not running

Examples

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

External temperature

Vehicle status service for external temperature status.

Resource

externalTemp

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Unit

celsius

Value

Integer - external temperature in celsius

Examples

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

Door front left open

Vehicle status service for front left door open status.

Resource

frontLeftDoorOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Door front right open

Vehicle status service for front right door open status.

Resource

frontRightDoorOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Door rear left open

Vehicle status service for rear left door open status.

Resource

rearLeftDoorOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Door rear right open

Vehicle status service for rear right door open status.

Resource

rearRightDoorOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Fuel amount

Vehicle status service for fuel amount status.

Resource

fuelAmount

Scopes

  • openid

  • exve:fuel_status

Response body

Unit

liters

Value

Integer - fuelAmount in liters

Examples

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

Hood open

Service for retrieving if the hood is open or closed.

Resource

hoodOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Kilometers to service

Vehicle status service for kilometers to service status.

Resource

kmToService

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Unit

kilometers

Value

Integer - number of kilometers

Examples

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

Main battery status

Vehicle status service for main battery status.

Resource

mainBatteryStatus

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Values

LOW
NORMAL

Examples

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

Months to service

Vehicle status service for months to service status.

Resource

monthsToService

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Unit

months

Value

Integer - number of months to service

Examples

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

Odometer

Vehicle status service for odometer specific information, this is the measured distance travelled by the vehicle.

Resource

odometer

Scopes

  • openid

  • exve:odometer_status

Response body

Unit

kilometers

Examples

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

Oil level

Vehicle status service for oil level status.

Resource

oilLevel

Scopes

  • openid

  • exve:diagnostics_engine_status

Response body

Values

VERY_LOW
LOW
NORMAL
HIGH
VERY_HIGH

Examples

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

Oil pressure

Vehicle status service for oil pressure status.

Resource

oilPressure

Scopes

  • openid

  • exve:diagnostics_engine_status

Response body

Values

LOW
NORMAL
HIGH
LOWSOFT
LOWHARD
NOSENSOR
SYSTEMFAULT

Examples

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

Service warning status

Vehicle status service for service warning status.

Resource

serviceWarningStatus

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Values

NORMAL
ALMOST_TIME_FOR_SERVICE
TIME_FOR_SERVICE
TIME_EXCEEDED

Examples

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

Service warning trigger

Vehicle status service for service warning trigger status.

Resource

serviceWarningTrigger

Scopes

  • openid

  • exve:diagnostics_workshop

Response body

Values

CALENDAR_TIME
DISTANCE
ENGINE_HOURS
ECM

Examples

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

Tail gate open

Service for retrieving if the hood is open or closed.

Resource

tailGateOpen

Scopes

  • openid

  • exve:doors_status

Response body

Values

true : open
false : closed

Examples

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

Trip meter 1

Vehicle status service for trip meter 1 status.

Resource

tripMeter1

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Unit

kilometers

Value

Integer - tripMeter1 in kilometers

Examples

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

Trip meter 2

Vehicle status service for trip meter 2 status.

Resource

tripMeter2

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Unit

kilometers

Value

Integer - tripMeter2 in kilometers

Examples

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

Tyre front left pressure

Vehicle status service for front left tyre pressure status.

Resource

frontLeftTyrePressure

Scopes

  • openid

  • exve:tyre_status

Response body

Values

LOW
NORMAL
HIGH
LOWSOFT
LOWHARD
NOSENSOR
SYSTEMFAULT

Examples

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

Tyre front right pressure

Vehicle status service for front right tyre pressure status.

Resource

frontRightTyrePressure

Scopes

  • openid

  • exve:tyre_status

Response body

Values

LOW
NORMAL
HIGH
LOWSOFT
LOWHARD
NOSENSOR
SYSTEMFAULT

Examples

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

Tyre rear left pressure

Vehicle status service for rear left tyre pressure status.

Resource

rearLeftTyrePressure

Scopes

  • openid

  • exve:tyre_status

Response body

Values

LOW
NORMAL
HIGH
LOWSOFT
LOWHARD
NOSENSOR
SYSTEMFAULT

Examples

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

Tyre rear right pressure

Vehicle status service for rear right tyre pressure status.

Resource

rearRightTyrePressure

Scopes

  • openid

  • exve:tyre_status

Response body

Values

LOW
NORMAL
HIGH
LOWSOFT
LOWHARD
NOSENSOR
SYSTEMFAULT

Examples

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

Washer fluid level

Vehicle status service for washer fluid level status.

Resource

washerFluidLevel

Scopes

  • openid

  • exve:vehicle_statistics

Response body

Values

VERY_LOW
LOW
NORMAL
HIGH
VERY_HIGH

Examples

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

Window front left open

Vehicle status service for front left window open status.

Resource

frontLeftWindowOpen

Scopes

  • openid

  • exve:windows_status

Response body

Values

true : open
false : closed

Examples

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

Window front right open

Vehicle status service for right window open status.

Resource

frontRightWindowOpen

Scopes

  • openid

  • exve:windows_status

Response body

Values

true : open
false : closed

Examples

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

Window rear left open

Vehicle status service for rear left window open status.

Resource

rearLeftWindowOpen

Scopes

  • openid

  • exve:windows_status

Response body

Values

true : open
false : closed

Examples

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

Window rear right open

Vehicle status service for rear right window open status.

Resource

rearRightWindowOpen

Scopes

  • openid

  • exve:windows_status

Response body

Values

true : open
false : closed

Examples

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

/