# Toronto Hydro Green Button Connect My Data

**Canonical:** https://apis.io/apis/toronto-hydro/toronto-hydro-green-button-connect-my-data/  
**Provider:** Toronto Hydro — https://apis.io/providers/toronto-hydro/  
**Documentation:** https://www.torontohydro.com/for-home/green-button

Toronto Hydro Green Button Connect My Data is one of 2 APIs that [Toronto Hydro](https://apis.io/providers/toronto-hydro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Green Button, Connect My Data, ESPI, Energy Usage, and Consumer Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

Toronto Hydro's Green Button Connect My Data (CMD) implementation, required of rate-regulated Ontario electricity utilities by O. Reg. 633/21 and built to the NAESB REQ.21 Energy Services Provider Interface (ESPI) v3.3 standard. A registered and approved third party receives a redirect to a Toronto Hydro authentication page where the customer signs in to their Toronto Hydro online account (or uses an alternate consent method if they have no online account) and authorizes ongoing machine-to-machine delivery of their electricity usage, billing and account data. Toronto Hydro publishes no base URI, no API reference and no machine-readable contract for this API — the resource shapes come from the ESPI standard rather than from the utility. Access is application-approval only, via the third-party onboarding portal operated by platform vendor Savage Data Systems, and requires a connectivity test plus acceptance of Toronto Hydro's Third Party Terms and Conditions for Green Button Connect My Data.

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/toronto-hydro/refs/heads/main/openapi/toronto-hydro-green-button-espi-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/toronto-hydro/refs/heads/main/overlays/toronto-hydro-green-button-espi-overlay.yaml
- **Documentation** — https://www.torontohydro.com/for-home/green-button
- **DeveloperPortal** — https://torontoonboarding.savagedata.com/
- **Registration** — https://torontoonboarding.savagedata.com/
- **TermsOfService** — https://www.torontohydro.com/green-button/third-party-terms
- **GettingStarted** — https://www.torontohydro.com/documents/d/guest/green-button-connect-my-data-customer-guide
- **Login** — https://www.torontohydro.com/my-account/green-button-connections
- **Certification** — https://www.greenbuttonalliance.org/testing
- **Documentation** — https://www.greenbuttondata.org/cmd.html
- **Documentation** — https://www.ontario.ca/laws/regulation/210633
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/toronto-hydro/refs/heads/main/apis.yml

## Other Toronto Hydro APIs (1)

- [Toronto Hydro Green Button Download My Data](https://apis.io/apis/toronto-hydro/toronto-hydro-green-button-download-my-data/)

## Tags

Green Button, Connect My Data, ESPI, Energy Usage, Consumer Data, Consent

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/toronto-hydro/toronto-hydro-green-button-connect-my-data/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/toronto-hydro/.