Volvo

The Volvo integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is used to integrate your Volvo vehicle.

Supported vehicles

  • Car models starting from model year 2010. Features available depend on model and year.
  • Cars located in Europe, Middle East, Africa, US, Canada, and Latin America regions. Or view the full list of countries.

Prerequisites

  1. Head over to Volvo’s developer portal.
  2. Make an account.
  3. Go to the API applications page.
  4. Create an API application and give it a meaningful name.

It’s recommended to add an API application per vehicle you want to add. There is a maximum on the number of requests that can be made per API key per day.

Configuration

To add the Volvo device to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

API key

Enter the API key obtained in the prerequisites steps.

VIN

If you have more than one car under this account, then you can select the Vehicle Identification Number of the vehicle you wish to add.

Supported functionality

The Volvo integration provides the following entities.

All engine types

Sensors

  • Car connection: Connectivity of the car
  • Distance to service: Remaining distance until the next service maintenance
  • Odometer: Odometer
  • Time to engine service: Remaining engine-hours until the next service maintenance
  • Time to service: Remaining time until the next service maintenance
  • Trip automatic average speed: Average speed on the automatic trip meter
  • Trip automatic distance: Total distance on the automatic trip meter
  • Trip manual average speed: Average speed on the manual trip meter
  • Trip manual distance: Total distance on the manual trip meter

Battery-only and plug-in hybrid

Sensors

  • Average energy consumption since charge: Average energy consumption since the last charge of the battery
  • Battery: Current state of charge of the battery
  • Battery capacity: Total capacity of the battery
  • Distance to empty battery: Electric range

Sensors for specific models

Go to Volvo’s developer portal to view the list of supported models.

  • Charging connection status: Charging connection status
  • Charging limit: Charging limit configured in the car
  • Charging power: Current charging power
  • Charging power status: Indication if power is being provided
  • Charging status: Indication if the car is charging or not
  • Charging type: AC or DC
  • Estimated charging time: Estimated charging time to reach the target battery charge level
  • Trip automatic average energy consumption: Average energy consumption on the automatic trip meter
  • Target battery charge level: Target battery charge level configured in the car
  • Trip manual average energy consumption: Average energy consumption on the manual trip meter

Fuel-only and plug-in hybrid

Sensors

  • Distance to empty tank: Fuel range
  • Fuel amount: Remaining fuel
  • Trip automatic average fuel consumption: Average fuel consumption on the automatic trip meter
  • Trip manual average fuel consumption: Average fuel consumption on the manual trip meter

Examples

Estimated charging finish time

The Volvo API only provides an estimated charging time (in minutes). To calculate the finish time, you can create a Template sensor helper with the template below.

{% set charging_time = states('sensor.volvo_YOUR_MODEL_estimated_charging_time') | int(0) %}
{% if charging_time > 0 -%}
  {% set new_time = now() + timedelta(minutes=charging_time) %}
  {{ new_time }}
{%- else -%}
  {{ this.state }}
{%- endif %}

Set the Device class to Timestamp and optionally choose your vehicle for Device.

Data updates

The Volvo integration fetches data from the API at different intervals:

  • Every 60 minutes: diagnostics, odometer, and statistics
  • Every 15 minutes: car connectivity and fuel status
  • Every 2 minutes: energy data (for battery cars)

If you decide to define a custom polling interval, beware that there is a maximum of 10,000 requests per day. Every poll operation accounts for about a dozen calls (depends on model).

Known limitations

The official Volvo app has access to a more feature-rich API. As a result, this integration cannot provide live updates, display tire pressure values, start air purifying, schedule climatization, show climatization status, and so on.

Troubleshooting

Recharge API

Symptoms

The Volvo integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] does not show recharge entities, or they are unavailable. This happens because sometimes the Volvo recharge API does not respond properly.

Resolution

The integration will automatically re-enable the recharge entities once the API becomes available again.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.

After deleting the integration, go to the app of the manufacturer and remove the Home Assistant integration from there as well.