Dear Viessmann API users,
We are announcing upcoming changes to the Viessmann API, effective April 30, 2025. These changes aim to improve the API's functionality and streamline the development process for our users.
API Endpoints Update
We are replacing several API endpoints with their current versions. This includes:
- /iot/v1/equipment/installations/{installationId}/gateways/{gatewaySerial}/devices/{deviceId}/features replaced with /iot/v2/features/installations/{installationId}/gateways/{gatewaySerial}/devices/{deviceId}/features
- /iot/v1/equipment/installations/{installationId}/gateways/{gatewaySerial}/features replaced with /iot/v2/features/installations/{installationId}/gateways/{gatewaySerial}/features
- /iot/v1/equipment/installations/{installationId}/features replaced with /iot/v2/features/installations/{installationId}/features
- /iot/v1/features replaced with /iot/v2/features
Important Notes:
- The previous versions (/iot/v1/...) of the listed endpoints will be removed entirely on April 30, 2025. As a result, any existing integrations using these endpoints will cease to function.
- The new endpoints (/iot/v2/...) function identically to their predecessors. There are no changes to the request parameters, response formats, or any other functional aspects.
Action Required
To ensure a smooth transition, we strongly recommend that you update your integrations to use the new API endpoints (/iot/v2/...) before April 30, 2025. The new endpoints are already available for use.
We understand that this change may require some adjustments to your existing code. To assist you in this process, we recommend referring to the API documentation.
Support Channels
If you have any questions or require further assistance regarding this update, please don't hesitate to reach out to our developer community forum or send an email to developer@viessmann.com.
We appreciate your understanding and cooperation as we continue to improve the Viessmann API.
All the best
Michael from the Viessmann Developer Portal Team
