Frequently asked questions

API usage

We have a rate limit with a sliding window. Whenever the first request arrives, we open a time window and count all requests in that window. If the number of requests reaches the limitation, we block all incoming user requests until the time window ends. Then, with the next user request, a new time window opens.

Currently, we have the following limits active: 1450 calls for a time window of 24 hours

Our API services range from IoT to integrate the data of your climate system over Service Documents that allow you to retrieve and access important system documents to User Management, which provides actions and general information about the user.

In the basic plan, the user has access to the main features of the climate system via the IoT API. This includes Remote Monitoring, Remote Control, Device Status and Statistics. Additionally, you have access to our Service Documents and User Management API. For more information on the Basic plan visit our Pricing Page and for the available features check our API Documentation.

The Advanced plan is intended for users and developers who need more than our Basic offering and can be booked directly via the Developer Portal. There are multiple benefits in the Advanced package, among them the ability to send more API requests per day and access to further features through the IoT API. For more information on the Advanced plan visit our Pricing Page and for the available features check our API Documentation.

 

The Basic plan is available to users in all countries.

 

 

For now, the Advanced plan is only available in the German market. But we are planning to provide the Advanced plan to further countries.

 

 

No. The Basic plan is free and unlimited in time.

 

When changing the heating system registration, your created API client remains valid for you. All you need to do is to retrieve the new Installation ID and Gateway Serial of your installation and exchange them with the previous (old) ones. More information on how to retrieve the ID and serial can be found in our API documentation.

For more details on our API and the usage check our API documentation.

Payment

Currently we only accept credit cards as payment but may accept other forms of payment in the future. If you are experiencing trouble with your preferred payment method, please contact us for support developer@viessmann.com

If the bank or financial institution declined the charge, check that your payment information such as postal code, security code, and expiration date are correct.

Currently we only accept credit cards as payment but may accept other forms of payment in the future. If you are experiencing trouble with your preferred payment method, please contact us for support developer@viessmann.com

 

In case of a failed booking, no money will be charged from your account.

If you need more help, contact us at developer@viessmann.com for direct support

 

Please note that the additional 0,50€ is not charged from your credit card. Your credit card will only be charged once with the amount of a monthly advanced package price.

During the checkout process and booking of the Developer Portal advanced package, you will receive an additional reservation on your credit card with an amount of 0,50€. We are currently working on avoiding a second reservation, but only one reservation, with the amount of the advanced package price, will be charged from us and you can neglect the other reservation. 

If you have any questions concerning this matter, feel free to reach out to developer@viessmann.com

 

You are automatically charged once a month on the date you signed up, which is the beginning ouf your payment cycle. This can take several days to appear on your account.

If your payment fails, your subscription will be suspended. In that case you would need to book a new subscription.

  • Go to our self-service portal on account.viessmann.com

  • Click on “Subscriptions”

  • Update your credit card information

If you have not updated your card information before the expiry date, then you will receive an automation email notification asking you to do so

 

  • Go to our  self-service portal on account.viessmann.com
  • Click on “Subscriptions”
  • Choose the subscription you would like to cancel
  • Cancel your active subscription

Yes. We inform every user in advance via email if subscription prices change.

 

If you are seeing multiple charges, or charges that you believe to be unauthorized from Viessmann, please contact us: developer@viessmann.com

 

Support

 

You can contact us via email at developer@viessmann.com or in our Viessmann Developer Community.

 

We are happy to get your thoughts and ideas. There are different ways to send us your feedback: