aid: alectra-utilities url: https://raw.githubusercontent.com/api-evangelist/alectra-utilities/refs/heads/main/apis.yml name: Alectra Utilities kind: company image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg tags: - Energy - Canada - Utilities - Electricity - Ontario - Green Button - Smart Metering - Energy Data - Grid - Municipal Utility - ESPI created: '2026-07-27' modified: '2026-07-27' specificationVersion: '0.19' description: >- Alectra Utilities Corporation is Ontario's second-largest municipally owned electricity distributor and one of the largest local distribution companies (LDCs) in Canada, serving roughly one million customers across seventeen communities in the Greater Toronto and Hamilton Area and the Golden Horseshoe — Alliston, Aurora, Barrie, Beeton, Bradford West Gwillimbury, Brampton, Guelph, Hamilton, Markham, Mississauga, Penetanguishene, Richmond Hill, Rockwood, St. Catharines, Thornton, Tottenham and Vaughan. It also bills water and wastewater/stormwater on behalf of several of those municipalities, and runs the GRE&T Centre for grid innovation. It sits squarely in the wires and metering layer of the Canadian value chain: it does not generate, it does not operate the market (the IESO does), and it is owned by its municipal shareholders rather than by investors — the Crown/municipal ownership pattern that dominates Canadian electricity. Its API posture exists only because a regulator created it. Ontario Regulation 633/21 (Energy Data) requires every Ontario electric and gas utility to implement Green Button Download My Data and Connect My Data to the NAESB REQ.21 ESPI v3.3 standard and to obtain Green Button Alliance certification, with an implementation deadline of 1 November 2023. Alectra publishes a Green Button page displaying GBA Certified DMD and CMD marks, a Green Button Connect My Data Terms and Conditions of Access and Use citing O. Reg. 633/21 by name, a live customer Green Button portal, and a live third-party registration and onboarding site — all three hosted by its data custodian vendor, Savage Data Systems, not by Alectra. What Alectra does not publish is any of the things that would let an outsider verify the implementation: there is no developer portal, no API documentation, no base URI, no OpenAPI, no scopes and no OAuth metadata anywhere on alectrautilities.com or on the portal host. developer., developers., docs. and data.alectrautilities.com do not resolve; /developers, /api, /docs, /data, /openapi.json and /swagger.json all return HTTP 404. Every path on the Green Button portal — including a deliberately invented control path — HTTP 302 redirects to a customer sign-in, so no endpoint could be confirmed. The resulting split is the finding: a mandated consumer-data API that a third party can reach only by completing an application and being approved, and zero open market or grid data of any kind, because in Ontario that layer belongs to the IESO and the OEB rather than to the distributor. apis: - aid: alectra-utilities:alectra-green-button-connect-my-data-api name: Alectra Utilities Green Button Connect My Data (CMD) API description: >- Alectra's mandated Green Button Connect My Data service, required of every Ontario electric and gas utility by Ontario Regulation 633/21 (Energy Data) and implemented to the NAESB REQ.21 Energy Services Provider Interface (ESPI) v3.3 standard. It lets an Alectra account holder authorise the ongoing, secure transfer of their electricity usage and billing data, in the standardised Green Button XML format, to a third party that Alectra has approved. Access is not self-serve: a developer must complete Alectra's third-party registration and onboarding at https://alectrautilitiesonboarding.savagedata.com/ (HTTP 200 on 2026-07-27, a Blazor application titled "3rdPartyRegistration" hosted by Alectra's data custodian vendor Savage Data Systems), accept the Green Button Connect My Data Terms and Conditions of Access and Use, and undertake to follow the Green Button Rules and Standards at greenbuttondata.org, provide a privacy policy and a cybersecurity policy to customers, and use the data only for purposes the customer expressly consented to. No base URI is recorded here because Alectra publishes none — the endpoint is disclosed to approved third parties through onboarding. Alectra's customer Green Button portal at https://alectrautilitiesgbportal.savagedata.com/ returned HTTP 200 on 2026-07-27 and exposes the ESPI path shape /DataCustodian/espi/1_1/resource/..., but that could not be treated as proof: every path on that host, including a bogus control path, HTTP 302 redirects to /Connect/Authorize, a customer sign-in form asking for account name and phone number. The OpenAPI carried in properties[] is the Green Button Alliance's own documentation of the CMD ESPI API, harvested verbatim with provenance — it is the standard's contract, not Alectra's. humanURL: https://alectrautilities.com/green-button-connect-my-data-terms-and-conditions-access-and-use tags: - Green Button - Connect My Data - ESPI - Energy Data - Usage - Billing - Consent - Ontario - Canada properties: - type: OpenAPI url: openapi/alectra-utilities-green-button-espi-openapi.json - type: Overlay url: overlays/alectra-utilities-green-button-espi-overlay.yaml - type: Authentication url: authentication/alectra-utilities-authentication.yml - type: OAuthScopes url: scopes/alectra-utilities-scopes.yml - type: Conventions url: conventions/alectra-utilities-conventions.yml - type: ErrorCatalog url: errors/alectra-utilities-problem-types.yml - type: DataModel url: data-model/alectra-utilities-data-model.yml - type: AgentSkill url: skills/_index.yml - type: Documentation url: https://alectrautilities.com/green-button - type: Documentation url: https://alectrautilities.com/green-button-connect-my-data-terms-and-conditions-access-and-use - type: PrivacyPolicy url: https://alectrautilities.com/green-button-privacy-policy - type: Registration url: https://alectrautilitiesonboarding.savagedata.com/ - type: Portal url: https://alectrautilitiesgbportal.savagedata.com/ - type: Documentation url: https://www.greenbuttondata.org/cmd.html - type: Documentation url: https://www.greenbuttonalliance.org/certification common: - type: DomainSecurity url: security/alectra-utilities-domain-security.yml - type: Conformance url: conformance/alectra-utilities-conformance.yml - type: Lifecycle url: lifecycle/alectra-utilities-lifecycle.yml - type: Packages url: packages/alectra-utilities-packages.yml - type: LLMsTxt url: llms/alectra-utilities-llms.txt - type: AgentSkill url: skills/_index.yml - type: Website url: https://alectrautilities.com/ - type: Documentation url: https://alectrautilities.com/green-button - type: PrivacyPolicy url: https://alectrautilities.com/green-button-privacy-policy - type: TermsOfService url: https://alectrautilities.com/green-button-connect-my-data-terms-and-conditions-access-and-use - type: Registration url: https://alectrautilitiesonboarding.savagedata.com/ - type: Portal url: https://myalectra.alectrautilities.com/ - type: Support url: https://myalectra.alectrautilities.com/portal/#/Help/General%20Inquiry - type: Blog url: https://www.alectra.com/news - type: BlogRSS url: https://alectrautilities.com/rss.xml - type: Newsletter url: https://alectrautilities.com/newsletter - type: Contact url: https://alectrautilities.com/contact-us - type: LinkedIn url: https://www.linkedin.com/company/alectra-utilities maintainers: - FN: Kin Lane email: kin@apievangelist.com