# Viessmann Heatpump consumption (API)

Source: https://docs.evcc.io/en/meters/viessmann-heatpump-consumption-api

Reads the heat pump's current electrical power consumption (heating.power.consumption.current) as an
additional consumer (aux). The heat pump then appears under "Consumption" in the energy flow and its
usage feeds the evcc statistics - independent of whether evcc controls the heat pump.

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| clientid | Client ID Configure at [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com) |  |  |
| redirecturi | Redirect URI Redirect URI of the evcc instance. Must match the redirect URI set in the Viessmann developer portal. |  |  |
| gateway_serial | Gateway Serial Determined automatically after login. Alternatively enter manually (ViCare app -> Settings -> Communication module -> Serial number) |  |  |
| installation_id | Installation ID Determined automatically after login. |  |  |
| device_id | Device ID typically `0` | 0 |  |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_aux
      type: template
      template: viessmann
      usage: aux
      clientid: # Client ID, Configure at [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
      redirecturi: # Redirect URI, Redirect URI of the evcc instance. Must match the redirect URI set in the Viessmann developer portal.
      gateway_serial: # Gateway Serial, Determined automatically after login. Alternatively enter manually (ViCare app -> Settings -> Communication module -> Serial number)
      installation_id: # Installation ID, Determined automatically after login.
      device_id: 0 # Device ID, typically `0`
```