The Viessmann API Themen

Einrichten in Homeassistent

MikelS — Fri, 11 Sep 2026 12:16:02 GMT

Ich möchte die Viessmann ViCare in meine HomeAssistent Anwendung integrieren, und suche nach einer geeigneten Anleitung

ViCare-Integration seit 11.09.2026 offline – Viessmann API meldet Gateway Offline

schrecke — Fri, 11 Sep 2026 11:39:53 GMT

Hallo zusammen,

seit heute, 11.09.2026, sind bei mir sämtliche Entitäten der Home-Assistant-ViCare-Integration nicht mehr verfügbar.

System:

Home Assistant OS
Core 2026.8.3
Supervisor 2026.09.0
OS 18.2
Raspberry Pi 5
Viessmann Vitocal 222-S mit Vitoconnect OPTO2
ViCare App funktioniert weiterhin und zeigt die aktuellen Werte korrekt an.

Bis heute ca. 10:15 Uhr wurden die Werte in Home Assistant ebenfalls noch korrekt aktualisiert. Danach keine Aktualisierung mehr.

Interessant ist, dass zeitgleich ein Home-Assistant-Neustart wegen eines Updates einer anderen Custom Integration (Huawei Solar) um ca. 10:12 Uhr stattfand. An ViCare/PyViCare wurde dabei nichts aktualisiert.

Debugging:

Home Assistant meldet beim Einrichten der ViCare-Integration:

aggregatedStatus: Offline

und erkennt die Geräte entsprechend als:

online: False

Ich habe deshalb mit demselben ViCare Access Token direkt außerhalb von Home Assistant die Viessmann API abgefragt.

Der Endpoint

/iot/v2/equipment/installations?includeGateways=true

liefert ebenfalls für Installation, Gateway und Geräte:

aggregatedStatus: Offline

Anschließend habe ich zusätzlich den Gateway direkt über

/iot/v2/equipment/gateways/

abgefragt.

Auch dort liefert die Viessmann API:

aggregatedStatus: Offline

Der Gateway meldet außerdem als letzten Statuswechsel:

2026-09-10T11:17:35.700Z

Firmware ist weiterhin 2.51.5.0, firmwareUpdateFailureCounter: 0.

Damit scheint das Problem aktuell nicht bei Home Assistant selbst zu liegen, sondern der Viessmann-API-Status des Gateways ist tatsächlich Offline.

Was mich dabei wundert: Die ViCare-App funktioniert gleichzeitig problemlos und zeigt aktuelle Werte der Anlage.

Hat jemand eine Erklärung dafür, warum die Viessmann API den Gateway als Offline führt, während die ViCare-App weiterhin aktuelle Daten bekommt?

Gibt es eventuell noch einen anderen API-Endpunkt bzw. Status, über den die App den tatsächlichen Gateway-Zustand ermittelt?

Danke!

Diese Komponente wurde bereits registriert. Wende dich an den Viessmann Service

CHRIS1385 — Sat, 05 Sep 2026 21:15:15 GMT

20260905_213611.jpg

„Diese Komponente wurde bereits registriert. Wende dich an den Viessmann Service.“

Da ich der neue Eigentümer bin, möchte ich die Anlage auf meinen Namen registrieren und die bisherigen Registrierungsdaten entsprechend ändern lassen.

API

mars3142 — Fri, 04 Sep 2026 19:13:43 GMT

Hi,

Ich bin komplett neu hier. Ich versuche gerade die API Doku für meine Viessmann Gasheizung zu finden. Es muss eine geben, denn ich kann via ViCare auf das System zugreifen.

Wo finde ich tiefergehende Informationen dazu? Ich brauche keine fertigen Lösungen, denn ich will die Daten selbst auslesen können.

Danke euch für Hinweise.

Historische Daten Vitocal 200-S Serie D - Vitoconnect

Eilenburg — Thu, 03 Sep 2026 11:36:56 GMT

Hallo,

ich suche zunehmend verzweifelt eine Möglichkeit, diverse Daten zu meiner Vitocal 200-S Serie D mit Vitoconnect zu finden/ auszulesen und per csv/json zu exportieren. Es geht mir ausdrücklich um Daten der vergangen Jahre, nicht um das was jetzt und in Zukunft passiert. Dafür hab ich Lösungen zum protokollieren. Ich habe einfach keine Muse, aus der App oder dem Display die Wochenverbräuche und Leistungen abzuschreiben. Insgesamt suche ich folgende Daten:

- Teil/ Gesamt JAZ bzw. COP für Heizung, Warmwasser und Kühen

- Stromverbrauch MSR, Heizung, Warmwasser und Kühlen

- Wärmeleistung für Heizung, Warmwasser und Kühlen

- Kompressorlaufzeit pro Stufe/ Tag

- Kompressorstarts/ Tag

- Stromanteil PV

Hat irgendwer eine Idee, wie ich da rankomme. Zumindest zu den Bereich Stromaufnahme und Wärmeabgabe gab es mal online bei Viessmann exportierbar.

Beste Grüße aus EB

4. Versuch: HTTP-Statuscode 410 bei 'heating.burners.0.statistics'

Nunu62 — Mon, 31 Aug 2026 16:00:01 GMT

Hallo,

ich habe seit ein paar Jahren eine Applikation auf einem ESP32 laufen, alles gut !!

Seit ein paar Wochen bekomme ich einen Fehler HTTP-Statuscode 410 Gone (Ressource dauerhaft gelöscht und nicht mehr existiert (Token-Erzeugung funktioniert!):

https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations/+ vsmInstallationID + "/gateways/" + vsmGatewaySerial + "/devices/" + vsmDeviceID + "/features/heating.burners.0.statistics";

Was ist falsch? Danke für Eure Hilfe !!

3. Versuch: HTTP-Statuscode 410 bei 'heating.burners.0.statistics'

Nunu62 — Wed, 26 Aug 2026 15:38:15 GMT

Hallo,

ich habe seit ein paar Jahren eine Applikation auf einem ESP32 laufen, alles gut !!

Seit ein paar Wochen bekomme ich einen Fehler HTTP-Statuscode 410 Gone (Ressource dauerhaft gelöscht und nicht mehr existiert (Token-Erzeugung funktioniert!):

https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations/+ vsmInstallationID + "/gateways/" + vsmGatewaySerial + "/devices/" + vsmDeviceID + "/features/heating.burners.0.statistics";

Was ist falsch? Danke für Eure Hilfe !!

Vitodens 222-F FR2B

66krieger — Wed, 26 Aug 2026 07:11:20 GMT

Hallo Partner. Ich habe die o.g. Brennwerttherme mit einem Vitocell 100 und möchte in meinem Home Assistant ein animiertes Schaltschema mit allen verfügbaren Mess- und Einstellwerten erzeugen. Ich finde einfach kein Schaltschema welches mir dazu als Vorlage dienen könnte.

3. Versuch: HTTP-Statuscode 410 bei 'heating.burners.0.statistics'

Nunu62 — Sun, 23 Aug 2026 10:13:19 GMT

Hallo,

ich habe seit ein paar Jahren eine Applikation auf einem ESP32 laufen, alles gut !!

Seit ein paar Wochen bekomme ich einen Fehler HTTP-Statuscode 410 Gone (Ressource dauerhaft gelöscht und nicht mehr existiert (Token-Erzeugung funktioniert!):

https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations/+ vsmInstallationID + "/gateways/" + vsmGatewaySerial + "/devices/" + vsmDeviceID + "/features/heating.burners.0.statistics";

Was ist falsch? Danke für Eure Hilfe !!

Authorization Code + PKCE flow returns invalid_grant despite verified-correct client config and a fresh code

Frank78 — Sat, 22 Aug 2026 18:20:10 GMT

Setup:
- Client type: public client, PKCE required (confirmed — see below), no client secret
- redirect_uri: http://localhost:4200/ (registered exactly as such in the developer portal, verified via the client editor UI)
- Scope requested: IoT User offline_access
- Grant: authorization_code with code_challenge_method=S256

Flow followed (per the Getting Started guide):
1. GET https://iam.viessmann-climatesolutions.com/idp/v3/authorize?client_id=...&redirect_uri=http://localhost:4200/&response_type=code&scope=IoT+User+offline_access&code_challenge_method=S256&code_challenge=...&state=...
2. Logged in interactively in a real browser (reCAPTCHA passed normally).
3. Browser redirects to http://localhost:4200/?code=...&state=... as expected — state always matches.
4. POST https://iam.viessmann-climatesolutions.com/idp/v3/token with grant_type=authorization_code, client_id, redirect_uri, code, code_verifier.

Result every time: 400 {"error":"invalid_grant","error_description":"Invalid grant"}

What I've ruled out, to save the next reader's time:
- PKCE math — independently recomputed BASE6and confirmed it matches the code_challengesent at step 1. - Code freshness / latency — set up a local irect URI that performs the token exchangeinline, in the same process, the instant the redirect lands (effectively zero delay between code issua exchange). Same invalid_grant.
- Client/redirect_uri mismatch — visually confirmed in the developer portal's client editor that the reg redirect URI is exactly http://localhost:4n both requests, and this was alreadyconfigured before any of these attempts (not something added reactively). - PKCE optionality — tried omitting code_cha entirely to see if this client accepts aplain authorization_code flow. Got a different, earlier error instead: invalid_request: "Code Challeng thrown at the /authorize step itself, befored. This confirms PKCE is mandatory for thisclient and that the client is otherwise reachable/valid. - Tested across 5 independent attempts with ier each time — same result every time.
Additional context: the same client_id can sccess token via the developer portal's own"try it" feature, and that token works fine against the IoT API. So the client itself is active and the client_id/scope combination is valid for APIthe browser-driven Authorization Code + PKCEexchange that fails.

Authorization Code + PKCE flow returns invalid_grant despite verified-correct client config and a fresh code

Frank78 — Sat, 22 Aug 2026 18:17:55 GMT

MS-R06 is active and working on live data — confirmed via the earlier successful test run.
- The invalid_grant mystery remains unresolved. Every check I can perform from outside says the request should work: client_id and redirect_uri match exactly (confirmed via your portal screenshot),

Result every time: 400 {"error":"invalid_grant","error_description":"Invalid grant"}

What I've ruled out, to save the next reader's time:
- PKCE math — independently recomputed BASE64URL(SHA256(code_verifier)) and confirmed it matches the code_challenge sent at step 1.
- Code freshness / latency — set up a local loopback listener on the redirect URI that performs the token exchange inline, in the same process, the instant the redirect lands (effectively zero delay between code issuance and exchange). Same invalid_grant.
- Client/redirect_uri mismatch — visually confirmed in the developer portal's client editor that the registered redirect URI is exactly http://localhost:4200/, matching what's sent in both requests, and this was already configured before any of these attempts (not something added reactively).
- PKCE optionality — tried omitting code_challenge/code_challenge_method entirely to see if this client accepts a plain authorization_code flow. Got a different, earlier error instead: invalid_request: "Code Challenge Required", thrown at the /authorize step itself, before the login page even rendered. This confirms PKCE is mandatory for this client and that the client is otherwise reachable/valid.
- Tested across 5 independent attempts with fresh state/nonce/code_verifier each time — same result every time.

Additional context: the same client_id can successfully mint a working access token via the developer portal's own "try it" feature, and that token works fine against the IoT API. So the client itself is active and the client_id/scope combination is valid for API access — it's specifically the browser-driven Authorization Code + PKCE exchange that fails.

Analyse- und Ertragsdaten zur PV-Erzeugung

Odian — Tue, 18 Aug 2026 13:04:38 GMT

Hallo,

an meiner Anlage fehlen sämtliche Analyse- und Ertragsdaten zur PV-Erzeugung - in der ViCare-App ebenso wie über die IoT-API. Die Momentanwerte dagegen werden korrekt geliefert. Ich habe einen konkreten Verdacht zur Ursache und bitte um Prüfung.

ANLAGE

- Installations-ID: 176...
- Gateway 77361... (SA180Lan): Vitocharge VX3 (E3_VitoCharge_0420)
- Gateway 7782... (SA180): Vitovalor PT2 (E3_Vitovalor_PT2_0620), RoomControl One
- PV: 7,8 kWp, DC-Strings direkt am Vitocharge (ess.configuration.systemType = "hybrid")

SYMPTOM

Die aktuelle Stromerzeugung sehe ich in der ViCare-App. Was fehlt, sind die Analysen: kein PV-Ertrag in kWh für Tag, Monat oder Jahr.

VERDACHT: EXTERNES ENERGIEMANAGEMENT NOCH AKTIV

Ich habe bis 2023 eine GridBox (gridX) betrieben. Diese funktioniert seit 2023 nicht mehr, die Plattform wurde inzwischen ohnehin eingestellt. Für den Betrieb der GridBox musste seinerzeit am Vitocharge das externe Energiemanagement aktiviert werden. Meine Vermutung: diese Einstellung ist bis heute aktiv, obwohl es die GridBox faktisch nicht mehr gibt.

In Ihrer Community findet sich dazu eine Aussage Ihres Supports, wonach die Kacheln des Energiecockpits, die Autarkie-Anzeige und die Analysefunktion für Gesamterzeugung und -verbrauch genau dann verschwinden, wenn am Vitocharge das externe EnergyManagementSystem aktiviert ist (dort mit dem Ticket TVC-1246 an die Entwicklung gegeben). Das beschreibt mein Symptom exakt.

Dazu passen zwei Beobachtungen über die IoT-API:

1. Auf dem Vitocharge-Gateway ist weiterhin ein EEBus-Gerät registriert (device_id "EEBUS", model_id E3_EEBus_02) mit Status "Online". EEBus ist die Schnittstelle, über die seinerzeit die GridBox angebunden war.

2. Das Feature photovoltaic.production.cumulated - laut Ihrem Data-Points-Katalog die erzeugte Energie "in different periods" - antwortet mit HTTP 200, aber isEnabled: false und leerem properties-Objekt. Das Feature ist auf dem Gerät also bekannt, wird aber nicht gefüllt. Gleichzeitig liefern photovoltaic.production.current, photovoltaic.status, photovoltaic.string.voltage/.current sowie pcc.transfer.consumption.total und pcc.transfer.feedIn.total einwandfrei Werte.

MEINE FRAGEN

1. Ist das externe Energiemanagement an meinem Vitocharge tatsächlich noch aktiv? Das sollte sich anlagenseitig auslesen lassen.
2. Wie wird es deaktiviert, und wer muss das tun - ich selbst, der Fachbetrieb oder Ihr Service?
3. Kehren danach die Analysefunktionen in ViCare und die Werte in photovoltaic.production.cumulated zurück? Lassen sich zurückliegende Erträge nachträglich wiederherstellen, oder beginnt die Aufzeichnung bei null?
4. Hat die Deaktivierung Nebenwirkungen, mit denen ich rechnen muss - etwa auf Batterieregelung, Einspeisebegrenzung oder Eigenverbrauchsoptimierung?
5. Kann das registrierte EEBus-Gerät entfernt werden, wenn es keine Gegenstelle mehr hat?

NEBENFRAGE ZUM VITOVALOR PT2

Ihr Katalog dokumentiert fuelCell.power.production und fuelCell.power.production.lastTwoYears ("generated electrical energy over the last two years") sowie die als DEPRECATED markierten Varianten unter heating.fuelCell.power.production. Alle vier antworten bei mir auf beiden Gateways mit HTTP 404. Mein PT2 liefert nur heating.power.production.cumulative als Gesamtwert ohne Perioden (derzeit 22.766 kWh).

Sind diese Features einem anderen Gerätetyp oder Firmwarestand vorbehalten? Und gibt es für den PT2 einen anderen Weg zur erzeugten elektrischen Energie je Tag, Monat oder Jahr?

Sollte diese Adresse nicht die richtige sein, wäre ich für eine Weiterleitung an die zuständige Stelle dankbar.

API Vitoair FS 300 E - Bypass fehlt

Jonathan3 — Tue, 18 Aug 2026 10:19:09 GMT

[english below]

Hallo zusammen,

ich habe meine Vitoair FS300E via API in Home Assistant eingebunden. Kann es sein, dass dort nicht alle Funktionen verfügbar sind, die es über die App für Endkunden gibt?

Beispielsweise finde ich keine Information und Steuerungsmöglichkeiten zum Bypass. Ist dies gewollt? Oder fehlt diese Funktion nur, weil es bisher zu wenig Bedarf dafür gab?

Oder habe ich bei der Einrichtung etwas falsch gemacht und/oder benötige ein zusätzliches Abo dafür?

Viele Grüße

Jonathan

________

Here is the English translation:

Hello everyone,

I integrated my Vitoair FS300E into Home Assistant via the API. Is it possible that not all functions available in the end-user app are supported there?

For example, I cannot find any information or control options regarding the bypass. Is this intentional, or is this feature simply missing because there hasn't been enough demand for it yet?

Or did I make a mistake during setup and/or need an additional subscription for this?

Best regards,

Jonathan

2. Versuch: HTTP-Statuscode 410 bei 'heating.burners.0.statistics'

Nunu62 — Mon, 17 Aug 2026 15:39:59 GMT

Hallo,

ich habe seit ein paar Jahren eine Applikation auf einem ESP32 laufen, alles gut !!

Seit ein paar Wochen bekomme ich einen Fehler HTTP-Statuscode 410 Gone (Ressource dauerhaft gelöscht und nicht mehr existiert (Token-Erzeugung funktioniert!):

https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations/+ vsmInstallationID + "/gateways/" + vsmGatewaySerial + "/devices/" + vsmDeviceID + "/features/heating.burners.0.statistics";

Was ist falsch? Danke für Eure Hilfe !!

Client data could not be loaded" – cannot create API client in Developer Portal

zs979797 — Mon, 17 Aug 2026 13:55:39 GMT

Hello, I am trying to create an API client in the Developer Portal (app.developer.viessmann-climatesolutions.com) in order to use the official Home Assistant ViCare integration. After logging in with my ViCare account credentials, the dashboard shows the error message "Client data could not be loaded". The "Your clients" tile does not load, so I cannot create or manage any API clients. I have tried: - different browsers - clearing cache / private window - logging out and back in The problem persists. I can see several other users reporting the same issue in this forum over the past days. Could you please reset / clean up my developer account data in the backend so the dashboard loads properly? The email address of this forum account is the same as my Viessmann account email. Thank you very much!

Fehler im Developer Portal: "Not possible to load client data" / Bitte um Backend-Bereinigung

davp81 — Sun, 16 Aug 2026 10:48:59 GMT

Hallo Support-Team,

ich versuche mich im Viessmann Developer Portal anzumelden, erhalte jedoch direkt nach dem Login die Fehlermeldung "Not possible to load client data". Die Dashboard-Oberfläche lädt dadurch nicht und ich kann keine API-Clients verwalten oder neu erstellen.

In den Entwicklertools meines Browsers wird bei der Anfrage ein Fehler (404/500) für eine alte Client-ID angezeigt. Das Problem scheint an einem asynchronen Zustand in der Backend-Datenbank zu liegen (evtl. durch das Löschen eines früheren Clients).

Könnten Sie bitte meinen Entwickler-Account bzw. die API-Client-Daten im Backend zurücksetzen, damit das Dashboard wieder sauber lädt? Meine Login-E-Mail entspricht der E-Mail-Adresse dieses Foren-Accounts.

Vielen Dank und viele Grüße!

API request

Wandelaar — Fri, 14 Aug 2026 18:54:22 GMT

Wanneer ik via de developer portal een API client wil aanmaken krijg ik de boodschap: "client data could not be loaded" en kan ik dus geen client aanmaken.

Hoe kan ik dit oplossen?

Neuen Client im Developer Portal per Dashboard anlegen (Home Assistant API)

uwilkenh — Fri, 14 Aug 2026 11:25:40 GMT

Hallo,

ich versuche einen neuen Client in meinem Developer Portal Zugang (basic) anzulegen aber schon der dafür nötige Button taucht nicht auf.

Es geht um die Client ID welche für die Home Assistant Integration benötigt wird.

Kann jemand helfen da ich hier keine Hinweise gefunden habe?

Grüße

Klimasensor ZK03839

Robert21 — Wed, 05 Aug 2026 08:44:32 GMT

Hallo, bei mir wurde kürzlich eine Wärmepumpe installiert inkl. Heizkörperthermostate. Zusätzlich habe ich einen Klimasensor ZK03839, den ich gerne mit einem USB Netzteil betreiben möchte. Die Installation im Batteriemodus funktioniert einwandfrei. Sobald ich das Netzteil (ohne Datenleitungen) anschließe, verschwindet der Sensor aus der ViCare-App. Ist es möglich, den Sensor irgendwie doch mit USB-Power zu integrieren oder funktioniert der ausschließlich nur im Batteriemodus?

Vitodens 300-W (WB3D) – Vitoconnect OPTO2/OPTO3 und Schreibzugriff über die API

SuperFabi — Mon, 03 Aug 2026 15:31:06 GMT

Hallo zusammen,

ich möchte meine Vitodens 300-W, Typ WB3D, an die ViCare App anbinden und anschließend über die offizielle ViCare-Integration in Home Assistant einbinden.

Herstell-Nr.: 7424972004901100

Drei Fragen dazu:

1. Welche Vitotronic-Regelung ist laut eurem System bei dieser Anlage verbaut?

2. Ist die Anlage mit dem Vitoconnect kompatibel – und spielt es eine Rolle, ob ich OPTO2 oder OPTO3 nehme? Im Handel laufen beide unter der Artikelnummer ZK03836, die Beschreibungen widersprechen sich aber teilweise.

3. Zum Funktionsumfang der API: Ich habe hier im Forum gelesen, dass bei einer WB3D in der App nur die Betriebsart "Ferien" wählbar war, während bei einer neueren B3HA zusätzlich Spar- und Komfortbetrieb verfügbar sind – in der Feature-Liste stand der entsprechende Befehl einmal auf isEnabled: false und einmal auf true. Ist das bei meiner Anlage ebenfalls zu erwarten, oder lässt sich das freischalten? Für Automationen wäre der Schreibzugriff auf Betriebsart und Solltemperaturen der entscheidende Punkt.

Die Anlage läuft witterungsgeführt, ein Außentemperatursensor ist vorhanden und die Außentemperatur wird auf dem Display angezeigt.

Vielen Dank für eure Hilfe!