{"id":15091153,"url":"https://github.com/kritsel/tado-openapispec-v2","last_synced_at":"2025-04-19T14:40:54.395Z","repository":{"id":250910000,"uuid":"834855601","full_name":"kritsel/tado-openapispec-v2","owner":"kritsel","description":"Community managed tado API definition (OpenAPI schema), documenting the operations in the https://my.tado.com/api/v2 tado API","archived":false,"fork":false,"pushed_at":"2025-03-24T07:50:27.000Z","size":288,"stargazers_count":26,"open_issues_count":7,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T08:43:49.692Z","etag":null,"topics":["api-definition","openapi","tado","tado-api"],"latest_commit_sha":null,"homepage":"https://kritsel.github.io/tado-openapispec-v2/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kritsel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-28T15:12:17.000Z","updated_at":"2025-03-18T10:51:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"d7ea0a13-1e4b-4119-91ac-2719a456a2b4","html_url":"https://github.com/kritsel/tado-openapispec-v2","commit_stats":{"total_commits":86,"total_committers":1,"mean_commits":86.0,"dds":0.0,"last_synced_commit":"48c24554df5bea44e377f2b0be82779f7987b8b2"},"previous_names":["kritsel/tado-openapispec-v2"],"tags_count":91,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kritsel%2Ftado-openapispec-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kritsel%2Ftado-openapispec-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kritsel%2Ftado-openapispec-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kritsel%2Ftado-openapispec-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kritsel","download_url":"https://codeload.github.com/kritsel/tado-openapispec-v2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249716420,"owners_count":21315066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-definition","openapi","tado","tado-api"],"created_at":"2024-09-25T10:35:59.311Z","updated_at":"2025-04-19T14:40:54.382Z","avatar_url":"https://github.com/kritsel.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"![content](https://img.shields.io/badge/content-tado_API_definition-blue)\r\n![API definition language](https://img.shields.io/badge/API_definition_language-OpenAPI_3.0.0-blue)\r\n[![release](https://img.shields.io/github/v/release/kritsel/tado-openapispec-v2)](https://github.com/kritsel/tado-openapispec-v2/releases)\r\n[![repo stars](https://img.shields.io/github/stars/kritsel/tado-openapispec-v2?style=plastic)](https://github.com/kritsel/tado-openapispec-v2/stargazers)\r\n[![last commit](https://img.shields.io/github/last-commit/kritsel/tado-openapispec-v2)](https://github.com/kritsel/tado-openapispec-v2/commits/main/)\r\n![open for contributors](https://img.shields.io/badge/open_for_contributors-yes-blue)\r\n[![contributors](https://img.shields.io/github/contributors/kritsel/tado-openapispec-v2)](https://github.com/kritsel/tado-openapispec-v2/graphs/contributors)\r\n\r\n*Full documentation is available in [this repo's Wiki](https://github.com/kritsel/tado-openapispec-v2/wiki).\r\nThis README is a summary.*\r\n\r\n# About tado\u0026ordm;, tado API and this tado API definition\r\n\r\n## tado\u0026ordm; and the tado API\r\n\r\ntado\u0026ordm; (https://www.tado.com/) is a german based company which offers a smart thermostat solution\r\nto control heating and air-conditioning in your home.\r\nThey sell hardware and subscription based add-on services.\r\nThese can be controlled via a mobile app or a webapp on their website.\r\n\r\nThe apps use a tado API which is available at https://my.tado.com/api/v2.\r\ntado\u0026ordm; allows third-party developers to use this API for their own projects,\r\n(see [here](https://community.tado.com/en-gb/discussion/23573/tado-x-breaking-api-changes))\r\nbut they do not provide any kind of support or publish documentation.\r\n\r\n## tado API definition\r\n\r\nThis repository contains a community managed API definition for the\r\n**tado API v2** which is hosted on https://my.tado.com/api. It uses OpenAPI v3.0.0 as its specification language.\r\nThe API definition is based on the experience of software developers who are experimenting\r\nwith the API to create their own solutions.\r\n\r\nThis API definition is not maintained or officially published by the tado\u0026ordm; company.\r\nThe contents of this API definition is a best-effort product.\r\nThere are no guarantees that this API definition is a complete and\r\ncorrect representation of the actual API as exposed via https://my.tado.com/api/v2.\r\n\r\nAs the owner of the repo I do not have any ties to the tado\u0026ordm; company.\r\nI simply like to create a space where knowledge about the tado API can be centralized and shared in a standardized form,\r\nso it becomes easier for software developers interested in home automation to use the API.\r\n\r\n\r\nLinks to the API definition in various formats:\r\n * **file in this GitHub repo**: [tado-openapispec-v2.yaml](tado-openapispec-v2.yaml)\r\n * **raw content**: https://raw.githubusercontent.com/kritsel/tado-openapispec-v2/latest/tado-openapispec-v2.yaml\r\n * **Swagger UI**: https://kritsel.github.io/tado-openapispec-v2/swagger.html\r\n\r\n# API support for tado\u0026ordm; X\r\n\r\nThe tado API hosted on https://my.tado.com/api has limited support for tado\u0026ordm; X devices.\r\nTado\u0026ordm; hosts a separate API geared towards tado\u0026ordm; X.\r\n\r\nMore info is available at https://github.com/kritsel/tado-openapispec-v2/wiki/tado-X\r\n\r\n# Acknowledgments\r\nWithout the groundwork done by **Stephen C. Phillips** \r\n(https://blog.scphillips.com/posts/2017/01/the-tado-api-v2/)\r\nand **Terence Eden** (https://shkspr.mobi/blog/2019/02/tado-api-guide-updated-for-2019/)\r\nI would have never started experimenting with the tado API,\r\nand this API definition would have never seen the light of day.\r\n\r\nAdditionally, the following GitHub members and repositories have been a great help:\r\n * [**mattdavis90** Matt Davis](https://github.com/mattdavis90): https://github.com/mattdavis90/node-tado-client\r\n * [**clambin** Christophe Lambin](https://github.com/clambin)\r\n * [**wmalgadey** Wolfgang Malgadey](https://github.com/wmalgadey): sharing information about tado\u0026ordm; X support\r\n\r\n\r\n# Contribute\r\nFeel free to submit a PR or create an issue if you want to contribute to this\r\nAPI definition.\r\n\r\nSpecial request for owners of the new tado X hardware: if you have knowledge about any https://my.tado.com/ endpoints\r\ndescribed in this definition which do not work as described, please create an issue (or submit a PR) with\r\ndocumentation improvement suggestions.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkritsel%2Ftado-openapispec-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkritsel%2Ftado-openapispec-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkritsel%2Ftado-openapispec-v2/lists"}