Toronto Hydro

aid: toronto-hydro
url: https://raw.githubusercontent.com/api-evangelist/toronto-hydro/refs/heads/main/apis.yml
name: Toronto Hydro
kind: company
description: Toronto Hydro is the municipally owned local electricity distribution company (LDC) for the City of Toronto,
  delivering power to roughly 800,000 residential and business customers across Canada's largest city. It sits in the wires-and-meters
  layer of Ontario's electricity value chain — it does not generate power and it does not run the wholesale market (that is
  IESO) — so the only customer-facing data it owns is smart-meter consumption, billing and account data. Its API posture is
  a clean example of a mandate that produced an implementation but not a developer product — Ontario's O. Reg. 633/21 under
  the Electricity Act, 1998 compelled rate-regulated electricity and gas utilities to offer Green Button Download My Data
  and Connect My Data conforming to NAESB REQ.21 ESPI v3.3 by 1 November 2023, and Toronto Hydro runs both — customer-facing
  Download My Data and Connect My Data pages behind its account login, a published third-party terms-and-conditions document,
  and a live third-party onboarding portal operated by its platform vendor Savage Data Systems. But there is no developer.torontohydro.com,
  no docs. or api. subdomain, no published base URI, no OpenAPI, and no self-serve keys. Consumer data is available only to
  companies that apply, pass a connectivity test and sign the third-party terms; market and grid data are not published openly
  at all. Mandated, implemented, and completely gated.
image: https://www.torontohydro.com/favicon.ico
tags:
- Energy
- Canada
- Utilities
- Electricity
- Smart Metering
- Green Button
- Grid
- Ontario
- Consumer Data
- Electricity Distribution
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: toronto-hydro:toronto-hydro-green-button-connect-my-data
  name: Toronto Hydro Green Button Connect My Data
  description: 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.
  humanURL: https://www.torontohydro.com/for-home/green-button
  tags:
  - Green Button
  - Connect My Data
  - ESPI
  - Energy Usage
  - Consumer Data
  - Consent
  properties:
  - type: OpenAPI
    url: openapi/toronto-hydro-green-button-espi-openapi.yml
  - type: Overlay
    url: overlays/toronto-hydro-green-button-espi-overlay.yaml
  - type: Documentation
    url: https://www.torontohydro.com/for-home/green-button
  - type: DeveloperPortal
    url: https://torontoonboarding.savagedata.com/
  - type: Registration
    url: https://torontoonboarding.savagedata.com/
  - type: TermsOfService
    url: https://www.torontohydro.com/green-button/third-party-terms
  - type: GettingStarted
    url: https://www.torontohydro.com/documents/d/guest/green-button-connect-my-data-customer-guide
  - type: Login
    url: https://www.torontohydro.com/my-account/green-button-connections
  - type: Certification
    url: https://www.greenbuttonalliance.org/testing
  - type: Documentation
    url: https://www.greenbuttondata.org/cmd.html
  - type: Documentation
    url: https://www.ontario.ca/laws/regulation/210633
- aid: toronto-hydro:toronto-hydro-green-button-download-my-data
  name: Toronto Hydro Green Button Download My Data
  description: Toronto Hydro's Green Button Download My Data (DMD) implementation, also required by O. Reg. 633/21 and built
    to NAESB REQ.21 ESPI v3.3. A Toronto Hydro customer signs in to their own account and downloads their electricity consumption,
    billing and customer data as a standards-conformant Green Button (ESPI XML) file they can hand to any tool they choose.
    This is a customer-account-gated self-service export rather than a programmatic API — there is no anonymous endpoint,
    no key, and no documented URL pattern — but the file it emits is a real, standardized, machine-readable energy-data artifact,
    which is what makes DMD the practical integration path for anyone not willing to complete third-party onboarding for CMD.
  humanURL: https://www.torontohydro.com/for-home/green-button
  tags:
  - Green Button
  - Download My Data
  - ESPI
  - Energy Usage
  - Consumer Data
  properties:
  - type: Documentation
    url: https://www.torontohydro.com/for-home/green-button
  - type: Login
    url: https://www.torontohydro.com/my-account/green-button-data
  - type: GettingStarted
    url: https://www.torontohydro.com/documents/d/guest/green-button-connect-my-data-customer-guide
common:
- type: DomainSecurity
  url: security/toronto-hydro-domain-security.yml
- type: Authentication
  url: authentication/toronto-hydro-authentication.yml
- type: OAuthScopes
  url: scopes/toronto-hydro-scopes.yml
- type: Conventions
  url: conventions/toronto-hydro-conventions.yml
- type: Conformance
  url: conformance/toronto-hydro-conformance.yml
- type: ErrorCatalog
  url: errors/toronto-hydro-problem-types.yml
- type: Lifecycle
  url: lifecycle/toronto-hydro-lifecycle.yml
- type: DataModel
  url: data-model/toronto-hydro-data-model.yml
- type: Packages
  url: packages/toronto-hydro-packages.yml
- type: WellKnown
  url: well-known/toronto-hydro-well-known.yml
- type: LLMsTxt
  url: llms/toronto-hydro-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Website
  url: https://www.torontohydro.com/
- type: Documentation
  url: https://www.torontohydro.com/for-home/green-button
- type: DeveloperPortal
  url: https://torontoonboarding.savagedata.com/
- type: Registration
  url: https://torontoonboarding.savagedata.com/
- type: SignUp
  url: https://torontoonboarding.savagedata.com/
- type: GettingStarted
  url: https://www.torontohydro.com/documents/d/guest/green-button-connect-my-data-customer-guide
- type: TermsOfService
  url: https://www.torontohydro.com/green-button/third-party-terms
- type: TermsOfUse
  url: https://www.torontohydro.com/terms-conditions
- type: PrivacyPolicy
  url: https://www.torontohydro.com/privacy-policy
- type: Legal
  url: https://www.torontohydro.com/conditions-of-service
- type: StatusPage
  url: https://outagemap.torontohydro.com/
- type: Support
  url: https://www.torontohydro.com/contact-us
- type: FAQ
  url: https://www.torontohydro.com/frequently-asked-questions
- type: Blog
  url: https://www.torontohydro.com/newsroom
- type: Regulations
  url: https://www.torontohydro.com/regulatory-information
- type: LinkedIn
  url: https://ca.linkedin.com/company/toronto-hydro
- type: Twitter
  url: https://twitter.com/torontohydro
- type: Facebook
  url: https://www.facebook.com/TorontoHydro/
- type: Instagram
  url: https://www.instagram.com/torontohydro/
- type: Youtube
  url: https://www.youtube.com/user/TorontoHydro
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com