My Tado Tado API
52
AI ReadinessFoundational (C-)52/100
Community OpenAPI document · agent-readyIOTHome Automationoauth213 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Read Tado home structure, zone state, and devices, plus override the heating or cooling schedule for a zone. Returns current temperature readings and zone state across 13 operations.
Use for: I need to set my living room temperature to 21 degrees for two hours, Check the current temperature in each zone, List all zones in my home, Get the weather at my home's location
Not supported: Does not control lighting, security cameras, or non-Tado devices - use for Tado smart heating and cooling zone control only.
The Tado API is the v2 surface used by the Tado web and mobile apps to manage smart heating and cooling devices in residential homes. It exposes home and zone configuration, current device state, weather at the home location, schedule timetables, and zone overlays that override the active schedule for a defined period. Authenticated users can read home structure, list devices, modify zone setpoints, and inspect each zone's capabilities and current readings.
Install Jentic One Beta
Connect the Tado API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Tado API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmy.tado.com%2Ftado" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmy.tado.com%2Ftado" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Tado API.
Read the authenticated user's profile and home memberships
Describe a home including its zones and connected devices
List all zones in a home with current state and capabilities
Set or remove a temperature overlay on a zone to override the schedule
Read the active schedule timetable and its time blocks for a zone
Pull weather conditions at the home location for context-aware automations
Inspect each zone's capabilities including supported temperature range and modes
Use Cases
Patterns agents use Tado API for, with concrete tasks.
★ Manual Temperature Override from a Voice Assistant
Let a voice assistant set a Tado zone to a specific temperature for a defined period. PUT /homes/{home}/zones/{zone}/overlay accepts a setpoint and termination condition (timer, manual, or schedule-aligned), then the zone holds that temperature until the overlay expires. DELETE on the same path returns the zone to its scheduled program in one call.
Call PUT /homes/{home}/zones/{zone}/overlay with setting=heating at 21 degrees and termination=TIMER for 7200 seconds, then DELETE the overlay when the user says 'cancel'.
Energy Usage Dashboard
Build a dashboard that shows current zone temperatures, target setpoints, and weather context to help residents understand heating behavior. The /homes/{home}/zones, zone state, and /homes/{home}/weather endpoints supply everything needed for a single-screen overview without polling individual devices. The 13-endpoint surface keeps the data model small and easy to refresh.
Refresh every 5 minutes: GET /homes/{home}/zones, then GET /homes/{home}/zones/{zone}/state for each, plus GET /homes/{home}/weather, and render a dashboard tile per zone.
Schedule Inspection and Audit
Inspect the configured weekly schedule for each Tado zone for compliance audits or energy reviews. The schedule timetable and timetable-blocks endpoints expose the full block-by-block program a zone runs through. Energy and facilities teams use this to flag zones that hold high setpoints overnight or during unoccupied hours.
Pull each zone's active timetable via /schedule/activeTimetable and then /schedule/timetables/{timetable}/blocks to compute hours per day above 20 degrees.
Geofencing Boost or Setback
Drive boost-on-arrival or setback-on-departure behavior from an external geofence event source. When the user crosses the geofence, the agent calls the overlay endpoint to bring zones to comfort temperature; on departure it removes the overlay so the schedule resumes. This complements Tado's built-in geofencing for households that drive automation from a different presence source.
On geofence-enter, PUT overlay at 20 degrees with termination=MANUAL on each zone; on geofence-exit, DELETE the overlay so the schedule resumes.
AI Agent Smart Home Assistant
Equip a Jentic-driven home assistant with Tado control as one of its tools. The agent searches Jentic for 'set Tado zone temperature', loads PUT /homes/{home}/zones/{zone}/overlay, and calls it in response to user requests. Jentic handles the OAuth 2.0 flow so the agent never sees the user's Tado credentials.
Through Jentic, search for 'override Tado zone temperature', load the overlay endpoint, and set the bedroom to 19 degrees until the next schedule change.
Key Endpoints
13 endpoints — the tado api is the v2 surface used by the tado web and mobile apps to manage smart heating and cooling devices in residential homes.
METHOD
PATH
DESCRIPTION
GET
/me
Get the authenticated user's profile
GET
/homes/{home}
Describe a home
GET
/homes/{home}/zones
List zones in a home
GET
/homes/{home}/zones/{zone}/state
Get current state of a zone
PUT
/homes/{home}/zones/{zone}/overlay
Set a temperature overlay on a zone
DELETE
/homes/{home}/zones/{zone}/overlay
Remove an overlay and return to schedule
GET
/homes/{home}/weather
Get weather at home location
GET
/me
Get the authenticated user's profile
GET
/homes/{home}
Describe a home
GET
/homes/{home}/zones
List zones in a home
GET
/homes/{home}/zones/{zone}/state
Get current state of a zone
PUT
/homes/{home}/zones/{zone}/overlay
Set a temperature overlay on a zone
DELETE
/homes/{home}/zones/{zone}/overlay
Remove an overlay and return to schedule
GET
/homes/{home}/weather
Get weather at home location
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
T
Tado API
- Foundational (C-)52/100
99
Foundational Compliance63
Developer Experience & Jentic Compatibility44
AI-Readiness & Agent Experience94
Agent Usability30
Security32
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
99
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
98%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: BSignals: 4
1%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
52%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
44
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: DSignals: 4
33%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
92%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
52%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
30
Security
Trust, risk posture, and security compliance.
Grade: FSignals: 1
30%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
32
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: FSignals: 1
32%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Tado API by hand means running its OAuth 2.0 password flow against the token endpoint, refreshing tokens, and threading home and zone ids through each heating call yourself. Through Jentic you install once, import the Tado API from the API Directory, complete the OAuth grant once, and your agent calls it.
Permission scoping
Tado puts the home and zone ids in the URL path (/homes/{home}/zones/{zone}/...), so a rule can pin your agent to one zone: it can read that zone's state and nothing else. You choose the operations it may call, so a call like setting or clearing the overlay is not included unless you add it.
Credential isolation
Your Tado OAuth grant is stored once, encrypted, by your own Jentic One instance, refreshed automatically, and injected at execution time. The tokens never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'set tado temperature' or 'list heating zones', and Jentic returns the matching Tado operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Tado API through Jentic.
What authentication does the Tado API use?
Tado uses OAuth 2.0. The user authenticates with their Tado account and the resulting access token is sent on each request. Through Jentic, the OAuth flow is handled in your Jentic One instance and tokens are refreshed automatically, so agent code never holds raw user credentials.
Can I set a specific temperature with the Tado API?
Yes. PUT /homes/{home}/zones/{zone}/overlay accepts a setting (heating mode and target temperature) and termination condition. The overlay holds until it expires or until you DELETE it on the same path to return to the schedule.
How do I remove a manual override through Jentic?
Through Jentic, search for 'remove Tado zone overlay', load DELETE /homes/{home}/zones/{zone}/overlay, and call it with the home and zone IDs. Jentic forwards the call with the OAuth access token and the zone returns to its scheduled program.
What are the rate limits for the Tado API?
Rate limits are not declared in the OpenAPI spec. Tado throttles high-frequency polling at the gateway, so refresh zone state on a 1-5 minute cadence rather than per-second polling, and back off on 429 responses.
Can I read the weather at my home location?
Yes. GET /homes/{home}/weather returns the current weather conditions Tado uses for its own automation. This is useful for context-aware rules like 'do not preheat if outside is already warm enough'.
Does the Tado API expose schedule timetables?
Yes. GET /homes/{home}/zones/{zone}/schedule/activeTimetable returns the active timetable and GET /homes/{home}/zones/{zone}/schedule/timetables/{timetable}/blocks returns its block-by-block program. Read these together for full audit visibility.
Can I limit what my agent is allowed to do with the Tado API?
Yes. Because you self-host Jentic One, your own rules decide which Tado operations and credentials the agent may use. Since Tado puts the home and zone ids in the URL path, you can pin the agent to a single zone and allow only read calls like GET /homes/{home}/zones/{zone}/state, so it sees that zone's state and nothing more. Write operations such as PUT or DELETE on /homes/{home}/zones/{zone}/overlay are excluded unless you explicitly add them.
GET STARTED