# ecobee

**Canonical:** https://apis.io/providers/ecobee/  
**Website:** https://www.ecobee.com  
**APIs profiled:** 7

ecobee makes smart Wi-Fi thermostats, room sensors, cameras, and other connected home devices. The ecobee API is a REST-like JSON interface, based at https://api.ecobee.com/1/, that lets authorized third-party applications read and control registered ecobee thermostats - retrieving live runtime state, settings, sensors, and equipment status, updating programs and comfort settings via thermostat functions, pulling historical runtime and meter reports, grouping thermostats, and (for EMS and Utility accounts) organizing thermostats in a management-set hierarchy and issuing demand response events. Authorization uses OAuth 2.0 with an ecobee PIN flow or the standard authorization-code flow, plus refresh tokens. NOTE - as of late 2024 ecobee closed its developer program to new API-key registrations; existing keys continue to function.

## Kin Score — 35.7 / 100 (thin)

Scored 2026-08-24 under rubric 0.13.0. Trend: flat (-0.4 from 36.1).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 56.9 |
| Governance | 0.0 |
| Contract Governance | 0.0 |
| Operational Transparency | 34.2 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 28.9 |
| Access Clarity | 28.9 |

Regulatory layer — **Energy & Utilities**: 16.2 (matched via tags).

## Agent readiness — 19.8 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (7)

- **ecobee Authorization API** — OAuth 2.0 PIN and authorization-code flows and token refresh.
- **ecobee Demand Response API** — Utility demand response events.
- **ecobee Group API** — Group registered thermostats.
- **ecobee Hierarchy API** — EMS/Utility management-set hierarchy of thermostats, sets, and users.
- **ecobee Reports API** — Historical runtime and meter reports.
- **ecobee Thermostat API** — Read thermostat state and poll for changes.
- **ecobee Thermostat Update API** — Update writable properties and run thermostat functions.

## Agentic access (1)

- **Ecobee Agentic Access** — 16 operations · 7 acting

## Security (2)

- **Ecobee Authentication** — http · 1 scheme
- **Ecobee Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Ecobee Plans Pricing**

## Tags

Smart Home, Thermostat, IoT, HVAC, Energy, Home Automation, Demand Response

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/ecobee/). Scores are computed from the provider's own public artifacts under a published rubric.