Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/koenzomers/tadoapi

API in .NET 9 to communicate with a Tado home heating/cooling system
https://github.com/koenzomers/tadoapi

c-sharp device-authentication net9 tado tado-api

Last synced: 5 months ago
JSON representation

API in .NET 9 to communicate with a Tado home heating/cooling system

Awesome Lists containing this project

README 

          
# Tado API

This library compiled for .NET 9 and .NET 10 will allow you to easily communicate with the Tado API and retrieve details about your Tado thermostats and zones and set their temperature.



[![licence badge]][licence]

[![Continuous Integration Build](https://github.com/KoenZomers/TadoApi/actions/workflows/cibuild.yml/badge.svg)](https://github.com/KoenZomers/UniFiApi/actions/workflows/cibuild.yml)



[licence badge]:https://img.shields.io/badge/license-Apache2-blue.svg

[licence]:https://github.com/koenzomers/TadoApi/blob/master/LICENSE.md



## Version History

0.7.0.0 - released November 19, 2025



- Added library for .NET 10

- Implemented optional cancellation token in HTTP calls to be able to cancel (long running) awaitable and retryable calls.



0.6.0.0 - released September 17, 2025



- Added handling for throttling since Tado started to roll out their new throttling. More info [here](https://community.home-assistant.io/t/tado-rate-limiting-api-calls/928751). In the old code it would just return empty lists when throttled, now it will throw a specific `Exceptions.RequestThrottledException` exception which holds all the details about the thottling, such as when it will be reset and what your daily quota is based on your subscription with Tado.



0.5.4.0 - released July 10, 2025



- Fixed an issue with GetZoneState not working



0.5.1.0 - released June 26, 2025



- Upgraded to .NET 9

- Rewrite to use Dependency Injenction

- Applied new Device Auth Flow which is [mandatory by Tado](https://support.tado.com/en/articles/8565472-how-do-i-authenticate-to-access-the-rest-api) as of March 21, 2025.

- It is NOT backwards compatible with previous versions of this library. You will need to rewrite your code to use the new API.



0.4.3.0 - released March 31, 2021



- Added `SetDeviceChildLock` to allow for enabling or disabling the child lock on a Tado device



0.4.2.0 - released February 3, 2021



- Added `GetZoneTemperatureOffset` to allow for getting the current temperature offset in a zone

- Added several variants of `SetZoneTemperatureOffsetFahrenheit` and `SetZoneTemperatureOffsetCelcius` which allow for the zone/room temperature offset to be set



0.4.1.0 - released April 19, 2020



- Added `SetHomePresence` to allow forcing the home state. Only seems to work for Tado v3+ members.

- Added `SetOpenWindow` and `ResetOpenWindow` to force the window state on a zone.

- Added `OpenWindowDetected` to `State` to get information on if an open window has been detected.

Thanks to [AndreasHassing](https://github.com/AndreasHassing) for his contributions to add these features.



0.4.0.1 - released January 15, 2020



- GetMe() wasn't returning any data when using the NuGet package. Fixed that in this version. Thanks to [twiettwiet](https://github.com/twiettwiet) for reporting this through [Issue #3](https://github.com/KoenZomers/TadoApi/issues/3)



0.4.0 - released March 4, 2019



- Converted the .NET Framework API library to .NET Standard 2.0 so it can be used from non Windows environments as well

- Updated Newtonsoft.JSON to version 12.0.1

- Updated the Unit Test packages to the latest version so the Unit Tests work again with the latest version of Visual Studio 2017



0.3.1 - released July 17, 2018



- Marked SetTemperatureCelsius and SetTemperatureFahrenheit as deprecated in favor of using SetHeatingTemperatureCelsius and SetHeatingTemperatureFahrenheit so it becomes clearer that the methods will set a heating temperature. The deprecated methods will stay for a few versions longer for backwards compatibility but will eventually be removed to avoid clutter in the code.

- Added a SetTemperature method which is the basic method used by the other temperature methods and removes duplicate code. As it may be tricky to use this method properly due to the many parameters, it is advised to use one of the methods that are targeting a specific goal, i.e. SetHeatingTemperatureCelcius or SetHotWaterTemperatureCelcius.

- Added comments to more entities to clarify what information they contain

- Added more enums for entities which seem to only be certain values. It may be that this breaks your current code by entities changing type from i.e. string to an enumerator.

- For the Hot Water boiler in Tado I'm currently assuming that this is always zone 0. If this isn't the case for your Tado setup, please let me know and I'll have to change the code to suit this scenario.



0.3 - released March 26, 2018



- Fixed an issue where a recursive loop would arise causing a StackOverflow exception as soon as the access token would expire and the refresh token would be used to get a new access token

- Updated the Client ID and Client Secret to be the special ones set up by Tado for 3rd parties, as by their request

- Fixed a disposal issue when providing proxy configuration to the Tado session instance



0.2.1 - released March 13, 2018



- Added option to provide duration of the heating or off to SetTemperatureCelcius, SetTemperatureFahrenheit and SwitchHeatingOff. This can be: until next manual change, until next scheduled event or for a specific duration.



0.2 - released January 31, 2018



- With big thanks to http://blog.scphillips.com/posts/2017/01/the-tado-api-v2/ added various methods that were listed there but not yet implemented. Full list of available functionalities can be found below.

- Removed old code and some code cleanup



0.1 - released January 30, 2018



- Initial version



## System Requirements



This API is built using Microsoft .NET 9 and is fully asynchronous



## Warning



Tado has not officially released an API yet that developers are free to use. This API has been created by mimicking the traffic to their own web application. This means they can change their Api at any time causing this Api and your code to break without advanced notice. Be sure you understand the consequences of this before using any Tado Api in your own software.



## Usage Instructions



Check out the UnitTest project in this solution for full insight in the possibilities and working code samples. If you want to run the Unit Tests, ensure the appsettings.json file is populated with the proper values valid for your scenario. Remember that it requires you to log on through your browser to Tado for it to get an access token. There is no other way anymore.



## Available via NuGet



You can also pull this API in as a NuGet package by adding "KoenZomers.Tado.Api" or running:



Install-Package KoenZomers.Tado.Api



Package statistics: https://www.nuget.org/packages/KoenZomers.Tado.Api



## Current functionality



With this API at its current state you can:



- Authenticate to the Tado v2 API using the device auth flow

- Validate with each request if the access token is still valid (lifetime is 10 minutes / 599 seconds) and if not, uses the refresh token to get a new access token (lifetime is 30 days)

- Retrieve information about the currently logged on user

- Retrieve information about all configured zones in your house

- Retrieve information about all registered Tado devices in your house

- Retrieve information about all connected mobile devices to your house

- Retrieve information about the Tado installations at your house

- Retrieve the users with access to a house

- Retrieve the details of a house

- Get the state if somebody is home

- Get the capabilities of a zone

- Get the settings of a mobile device with access to a house

- Get the summarized overview of zone

- Get information about the weather around your house

- Get the early start setting of a zone

- Switch the early start setting of a zone to enabled or disabled

- Set the desired heating temperature in a zone in Celsius and Fahrenheit

- Switch off the heating in a zone

- Switch the hot water boiler on and off

- Show Hi on Tado thermostats or Tado knobs

- Get the temperature offset for a zone/room/device

- Set the temperature offset for a zone/room/device

- Enable or disable the child lock feature on a Tado device



## Still missing



- Setting heating schedules



## Feedback



I cannot and will not provide support for this library. You can use it as is. Feel free to fork off to create your own version out of it. Pull Requests and Issues are not accepted.