tado API

Mike · November 2018

Does tado have an API ? Where can I find the documentation ?

Emcee · May 2024

Update (7 March 2025)

Hello everyone,

Please be advised that, to meet strict security standards, we will be removing access to grant flow for official tado° applications on 21 March 2025.

For those of you who've written your own software, we’ve provided an alternate method of authentication. Check out this article for details.

Home Assistant and python-tado° have already been informed. They’ve confirmed that they'll provide an update by 21 March.

If you’re using any other open-source or commercial home automation software, we recommend reaching out to them directly.

___________________

Previous post (Spring 2024):

Hello everyone,

Thank you for your interest in tado°'s products and, by extension, the company's API.

Please be advised that, as of 12 February 2024, third-party API authentication methods are no longer compatible with official tado° apps and devices. The documentation for API shared by our colleague in this very thread in January 2019 is also no longer compatible. This means that any and all requests produced following this and similar third-party documentation can no longer be executed.

The lack of compatibility between third-party API documentation and tado° products is rooted in the fact that the former incorrectly states users can substitute OAuth by username and password. This information is now outdated. It is no longer possible to do so.

Instead, we recommend updating your API authentication method using OAuth 2 by following the instructions in the following guide.

If you would like to learn more about this change, especially how it affects Home Assistant, you can also read through this thread.

Thank you for your continued involvement in tado°'s online community. We are always happy to hear from you!

Jurian · January 2019

Although we do have an API, at this time we do not provide any documentation or support for it.

At this time, the best documentation for the API can be found here:
https://www.openhab.org/addons/bindings/tado/

Please feel free to discuss any question you might have about the API in this topic together with other community members.

gerwitz · June 2019

It looks like the room (zone) temperature is read-only?

(My intention is to use the API to add small wireless temperature sensors to some rooms, where the human space is often very different than the TRV’s location.)

Germán · August 2019

Hello gerwitz,

As commented before, we don't support the API.

However, what you intend can probably be achieved easily through some of the free official integrations

Best,

Germán

Banshee · November 2019

gerwitz, did you get anywhere with this??

dennisoliver · November 2019

You can use the offset setting in the app to compensate for this. Just measure temp difference in the “human space” and check difference to TRV. Adjust the offset in the app in rooms setting.

Banshee · November 2019

dennisoliver, I’ve only found this useful up to a point. Sometimes the valves get warm before the room and shut off, then cool and come back on, rather than staying on until the room is up to temp. Would be neat to be able to add a small sensor.

Obviously you can add more Tado wall thermostats, but they’re not cheap!

MarkW · November 2019

Adjusting the offset only works to some degree and takes a long time to get right. Setting the system up this way also appears to affect the reporting side of the app, ie if you want a temp of 19 deg and to achieve this you have to offset 3 deg, then the human space temp will be 19 deg, the valve will show 19 deg but the temp at the valve will actually be 22 deg. However, the Air Comfort report appears to use the 'shown' temp with the offset, ie 19 deg. So, the report is actually incorrect. Might as well just set the valve to 22 deg.

jacoscar · December 2019

I just wrote a python script to correct the read temperature using an external sensor and it works great; now if I set a temperature, that temperature is effectively reached

samd · December 2019

@jacoscar Can we hear more about this please?

jacoscar · December 2019

Yes
My script connects to the Tado server to retrieve the current offset and the current temperature; then using home assistant API it retrieves the real temperature from another sensor (this could be any sensor as long as it can be used in Home Assistant)
It then calculates the new offset and applies it!
It repeats the cycle after a defined number of minutes (using 5 at the moment)
This effectively means that the Tado valve can pick up the heat of the radiator, but it will be dynamically corrected every 5 minutes

I would attach a picture but I am not in front of my computer now; I have opened a discussion in the italian Tado forum: if you find it, you’ll see a plot with the real temperature and the one reported by Tado with dynamic offset correction; you’ll see they are pretty much the same, meaning Tado is using the real temperature to request the right amount of heat

FranSuarez · December 2019

Really interesting jacoscar. Waiting for the script to use without an additional sensor of temp. Great job!

Jacopo · December 2019

Jon_On_A_Bike · December 2019

I've had a play, and written some code that directly sends offset information from an ESP8266 to Tado, using a DHT22 as the temperature sensor.

It's not great code, but it does work. It's probably a bad idea to use more than one, in case they try and connect at the same time.

I intend to replace it with several feeding into Home Assistant, to reduce the number of API calls

https://github.com/jon-riches/ESP8266-TADO

ps, I hesitated to publish this, if you don't understand it, it's probably not for you ;-)

casperwt · January 2020

@jacoscar, would you mind showing me your script home assistant script? I am looking for a similar solution, where my Hue motion sensors, which are already in all the rooms, deliver the correct room temperature. I'm just not sure how to write a script that pulls the pulls the real temperature, calculates the required offset and then pushes it to the right room in Tado.

Btw, is @Jacopo also your user?

edcldn · February 2020

Has anyone had any experience with Gérman’s suggested IFTTT integration? Using a third party thermostat to switch TRVs on and off?

Jon_On_A_Bike · March 2020

Anyone else using HomeAssistant who thinks that adding the offset the existing integration would be a good idea, vote here: -

Tado Integration - Put Offset

https://tado.vanillacommunities.com/en-gb/home/leaving?allowTrusted=1&target=https%3A%2F%2Fcommunity.home-assistant.io%2Ft%2Ftado-integration-put-offset%2F175964

Apologies if this is in the wrong place, as it’s a feature request for the existing Tado integration. The Tado integration is useful, but doesn’t include the functionality to change the thermostat offset, although it is available via the Tado API. The advantage of doing this is that it allows a separate (DIY / cheap) room thermostat to be used away from, and unaffected by, the direct heat from the radiator. There would need to be 2 additions - an extra ‘sensor’ that contained the current offse...

It also contains details of my work-around

_Marco_ · March 2020

In combination with a Homey from Athom (and there Tado App for Homey) and for example Aqara/Xiaomi zigbee sensors it is possible to do a lot extra with Tado.

I my self use the integration to switch between smart and not smart, but also for open window detection.

if windows is opened, set tado temp to 12 degr. for ever.

If window is closed, set back to smart.

If someone changes room temp and windows is still open, set it temp again to 12 degr after 10 second

hamoph · March 2020

@jacoscar would be great if you didn't mind sharing you python script that works for home assistant?

comboy · May 2020

@Jurian integrating through IFTT or any other existing platform is not a problem. But the API should be provided by the gateway itself. You guys created a great product, but it depends on your servers. It's fine for many personal use cases, but you could greatly expand your target by allowing it to work with closed systems. I should be able to control my TRV even even if my Internet is down or your servers are down or if tado servers don't exist anymore.

It really would be amazing to have a simple REST API on the gateway itself allowing your system to work without connecting to your servers. For some companies it is important not to share info with outside world when somebody is in the office or not, and a simple TRV can leak a lot of that kind of info. Same goes for home security.

I know it's a bit of a mess to use local API by your own app because people are sometimes at home not connected to their wifi, have different LAN for wireless and wired and so on. But adding such API on the gateway.. It would make your product go from great to amazing. Personally I'd order 10+ TRVs right away.

For more complex installations it would also allow installators to check RSSI to know how many gateways are necessary and so on. Home security systems would more realidy integrate with you.

You've made great hardware but you also seem to be a great software company, so I'm sure at some level you understand my crave for that local API. If you've dealt with more complex home automation installations you know that relying on external servers is always problematic. They all can be very reliable, but if you use 20 services, really often one of them temporarily have some problems, or somebody decided to change their web API etc. The end result is that things don't work way too often. With local API I can cut my tado off the Internet, use my integrations and it will work as long as hardware works.

Maybe that's enough begging. Thanks again for awesome product, I hope you'll consider the above. Cheers.

PS. Alternatively maybe realese specs for your 868 MHz TRV API, but I'm not sure if you do some firmware updates and whether it can change.

All of the above goes for Smart AC control too which other companies could integrate into their solutions if it would not rely on your server.

AndrewFG · September 2020

If you are of a technical nature, and you want to integrate your tado products into a home automation system, then you may be interested in the following links

The openHAB home automation system tado binding is described here
The openHAB binding uses the API (described via "Swagger") here
Also look at Terence Eden's blog about the tado API here and Stephen Philips blogs here

comboy · September 2020

@AndrewFG Thank you, I'm familiar with the links but I think they exploit API that tado uses for their website. Local API would be ideal as explained earlier, but if using API on their servers it should at least be official. Otherwise it may just change with the website redesign. There's also this client secret which can be easily used to cut off unofficial API use even without any redesign.

Time put into integration, testing and so on, may end up costing more than devices themselves. If API is gone then it all goes to waste.

DudleySquires · September 2020

@comboy @jurian @Germán and anyone else from tado, I read comboys most recent posts here and registered to just say that while I really like what tado provides, the one niggling doubt about the whole system is the total reliance on tado servers, internet connection and such. Local API, I guess via some sort of hub or new bridge, would be top of my list for improvements. Geo fencing, weather updates and such I can live without temporarily on the odd occasion there are issues, but to lose the scheduling functionality in such circumstances is too much (not to mention the possible scenario of the servers being switched off altogether).

gerwitz · November 2020

My specific interest has been addressed with the official temperature sensor, but I share the concerns here about dependance on an unofficial, external (cloud) API.

Unless I misunderstand, though, using HomeKit as the means of integration keeps any integration local, no?

AndrewFG · February 2021

I have a Tado Extension Unit model BU2 that is used to enable the central heating boiler. Does anyone know if there is an API command to read the state of its enable command relay?

elmopl · August 2021

However, what you intend can probably be achieved easily through some of the free official integrations, eg. IFTTT

Is there any place we can see what features are planned to be added to HomeKit API?

There are at least two features missing from making Tado valves a really nice option:

battery level information
fully open valve without requesting heat or changing temperature setting

Nice to have would be also ability to open valve partially.

I have installed handful of valves as test, and so far I really like the look and hardware, but being unable to control them properly (I do not want my heating system to be dependent on my Internet connection) makes me investigate other brands.

rhuijben · November 2022

See also the python https://github.com/germainlefebvre4/libtado wrapper around the same api used by those tools.

luteijn · November 2022

I don't think I really want to use that API, as it's for 'tado-the-cloud-based-software' and only indirectly controls the actual heating stuff. I'd like an API to 'tado-the-hardware-in-my-home'. Especially more direct control over the actuators (turn on that boiler, close that valve, how far is that radiator opened?). Most of the sensors are barely useful, as in the wrong locations, so being able to read them is not too important. Battery level would be nice, though.

Valaki1234 · December 2022

Is it possible to get the current flow temperature ?

Montage · December 2022

I’m not convinced Tado has that data. It doesn’t expose on my setup.

FranSuarez · December 2022

@Valaki1234 It' possible to see with tado pro app > System Check > connection details > current flow temperature

tado API

Welcome!

Best Answer

Answers

Tado Integration - Put Offset

Welcome!

Welcome!

Quick Links

Categories