EPCOR website screenshot

EPCOR

EPCOR Utilities Inc. is a municipally owned Canadian utility headquartered in Edmonton, Alberta, wholly owned by the City of Edmonton, that builds and operates electricity distribution and transmission, water and wastewater, and natural gas distribution systems across Alberta, Ontario and British Columbia in Canada and in Arizona, New Mexico and Texas in the United States. In its Alberta home market it is both a wires company for Edmonton and, through EPCOR Energy Alberta, a regulated-rate electricity retailer, sitting at the distribution-and-retail end of the value chain rather than in generation (generation was spun out as Capital Power in 2009). EPCOR runs no developer programme: epcor.com publishes no developer portal, no API documentation, no OpenAPI and no llms.txt, and the developer., developers., api., docs. and data. subdomains do not resolve. It nonetheless operates two real programmatic surfaces. The first is compelled: the Green Button Download My Data and Connect My Data service its three Ontario service areas - natural gas in the Aylmer area and electricity in the Collingwood and Kincardine areas - must run under Ontario's energy data regulation (O. Reg. 633/21), delivered behind a customer login and a third-party vendor registration portal, with EPCOR stating Green Button Alliance certification but publishing no base URI, no ESPI version and no technical contract. The second is accidental and entirely open: a public ArcGIS Online organization (owner epcor_outages) whose 36 production feature services - Edmonton power outage areas, Canadian water main breaks, water infrastructure projects, scheduled field events, and the outage and service-area layers for fourteen EPCOR Water USA districts in Arizona and New Mexico - answer anonymous ArcGIS REST queries with live data. EPCOR documents none of it, licenses none of it and announces none of it. The result is a utility that is open where a province compelled it, open where nobody noticed, and closed everywhere it would count as a product; wholesale market and system data still comes from AESO and IESO, not from EPCOR.

EPCOR publishes 1 API on the APIs.io network: Public Outage and Service Area Feature Services (ArcGIS REST). Tagged areas include Energy, Canada, Utilities, Electricity, and Natural Gas.

EPCOR’s developer surface includes authentication, developer portal, support, engineering blog, and 21 more developer resources.

42.9/100 developing ▬ flat Agent 41/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
2 APIs
EnergyCanadaUtilitiesElectricityNatural GasWaterGreen ButtonSmart MeteringGridOntarioAlbertaOutagesGeospatialOpen Data

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 42.9/100 · developing
Contract Quality 12.2 / 21
Developer Ergonomics 5.2 / 17
Access Clarity 3.6 / 17
Operational Transparency 1.7 / 11
Contract Governance 1.9 / 10
Discoverability 6.6 / 9
Regulatory Posture 9.1 / 15
Agent readiness — 41/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 6 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 4 / 4
Regulatory Posture applies to this provider. Its tags matched the Energy & Utilities regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/epcor: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

EPCOR Ontario Green Button (Download My Data / Connect My Data)

The Green Button energy-data service EPCOR operates for its three Ontario service areas (Aylmer-area natural gas, Collingwood-area and Kincardine-area electricity) to satisfy On...

EPCOR Public Outage and Service Area Feature Services (ArcGIS REST)

EPCOR's undocumented but fully public geospatial data surface. Its outage map at outages.epcor.com loads its endpoints from a configuration file that points at a publicly shared...

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

EPCOR public feature layer attributes

0 properties

JSON SCHEMA

Examples 6

Example request and response payloads for these APIs.

Epcor Outage Map Config

1 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Epcor Authentication

none/delegated-consent · 4 schemes

SECURITY

Epcor Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Epcor Agentic Access

115 operations

115 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 9

The organization behind the API

Scroll for all 9

Source (apis.yml)

apis.yml Raw ↑
aid: epcor
url: https://raw.githubusercontent.com/api-evangelist/epcor/refs/heads/main/apis.yml
name: EPCOR
kind: company
description: 'EPCOR Utilities Inc. is a municipally owned Canadian utility headquartered in Edmonton, Alberta, wholly owned
  by the City of Edmonton, that builds and operates electricity distribution and transmission, water and wastewater, and natural
  gas distribution systems across Alberta, Ontario and British Columbia in Canada and in Arizona, New Mexico and Texas in
  the United States. In its Alberta home market it is both a wires company for Edmonton and, through EPCOR Energy Alberta,
  a regulated-rate electricity retailer, sitting at the distribution-and-retail end of the value chain rather than in generation
  (generation was spun out as Capital Power in 2009). EPCOR runs no developer programme: epcor.com publishes no developer
  portal, no API documentation, no OpenAPI and no llms.txt, and the developer., developers., api., docs. and data. subdomains
  do not resolve. It nonetheless operates two real programmatic surfaces. The first is compelled: the Green Button Download
  My Data and Connect My Data service its three Ontario service areas - natural gas in the Aylmer area and electricity in
  the Collingwood and Kincardine areas - must run under Ontario''s energy data regulation (O. Reg. 633/21), delivered behind
  a customer login and a third-party vendor registration portal, with EPCOR stating Green Button Alliance certification but
  publishing no base URI, no ESPI version and no technical contract. The second is accidental and entirely open: a public
  ArcGIS Online organization (owner epcor_outages) whose 36 production feature services - Edmonton power outage areas, Canadian
  water main breaks, water infrastructure projects, scheduled field events, and the outage and service-area layers for fourteen
  EPCOR Water USA districts in Arizona and New Mexico - answer anonymous ArcGIS REST queries with live data. EPCOR documents
  none of it, licenses none of it and announces none of it. The result is a utility that is open where a province compelled
  it, open where nobody noticed, and closed everywhere it would count as a product; wholesale market and system data still
  comes from AESO and IESO, not from EPCOR.'
image: https://www.epcor.com/content/dam/epcor/images/dm-images/logos-and-icons/epcor-logo.png
tags:
- Energy
- Canada
- Utilities
- Electricity
- Natural Gas
- Water
- Green Button
- Smart Metering
- Grid
- Ontario
- Alberta
- Outages
- Geospatial
- Open Data
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: epcor:epcor-ontario-green-button
  name: EPCOR Ontario Green Button (Download My Data / Connect My Data)
  description: The Green Button energy-data service EPCOR operates for its three Ontario service areas (Aylmer-area natural
    gas, Collingwood-area and Kincardine-area electricity) to satisfy Ontario's O. Reg. 633/21. Download My Data lets an authenticated
    EPCOR customer download usage and billing data in an industry-standard XML format from the Green Button portal; Connect
    My Data ("Data Shares") lets a customer authorize a registered third-party vendor to receive energy usage data, billing
    data and/or account information on an ongoing basis via security tokens, with revocation from the portal's Data Shares
    tab. EPCOR states it has been certified by the Green Button Alliance. EPCOR publishes no technical documentation, no base
    URI, no ESPI/NAESB version reference and no machine-readable contract for this interface - a third party must apply through
    the vendor onboarding portal, and the customer-facing portal redirects every path to a login, so no endpoint could be
    verified anonymously. Not offered in EPCOR's Alberta or US service areas.
  humanURL: https://www.epcor.com/ca/en/on/collingwood-area/account/manage-account/green-button.html
  tags:
  - Energy
  - Green Button
  - Consumer Data
  - Electricity
  - Natural Gas
  - Ontario
  properties:
  - type: Documentation
    url: https://www.epcor.com/ca/en/on/collingwood-area/account/manage-account/green-button.html
  - type: Documentation
    url: https://www.epcor.com/ca/en/on/aylmer-area/account/manage-account/green-button.html
  - type: Documentation
    url: https://www.epcor.com/ca/en/on/kincardine-area/account/manage-account/green-button.html
  - type: Portal
    url: https://epcorgas.savagedata.com/
  - type: Registration
    url: https://epcorgasonboarding.savagedata.com/
  - type: Standard
    url: https://www.greenbuttonalliance.org/
  - type: Regulation
    url: https://www.oeb.ca/consumer-information-and-protection/green-button
  - type: AgentSkill
    url: skills/epcor-request-ontario-green-button-data.md
- aid: epcor:epcor-outages-arcgis
  name: EPCOR Public Outage and Service Area Feature Services (ArcGIS REST)
  description: 'EPCOR''s undocumented but fully public geospatial data surface. Its outage map at outages.epcor.com loads
    its endpoints from a configuration file that points at a publicly shared ArcGIS Online organization (services6.arcgis.com/Ji2rusuWXDFSqNsP,
    item owner epcor_outages, access public). Thirty-six production feature services answer anonymous ArcGIS REST queries
    with live operational data: Edmonton active and planned power outage areas with incident number, cause, affected-customer
    count, neighbourhoods and street ranges; Canadian water outages and main breaks; generic water events and scheduled field
    events; water infrastructure capital projects with status, lifecycle and typed dates; and per-district outage points plus
    service-area boundaries for fourteen EPCOR Water USA districts in Arizona and New Mexico. No API key, no signup, no rate
    limit, no licence, no terms of use and no support channel are published for it, and EPCOR''s own environment pipeline
    (dev/test/ist/uat copies) sits in the same public folder. Format is selected with an f parameter (json, geojson, pbf),
    paging uses resultOffset/resultRecordCount against a 2000-feature cap, and errors are returned with HTTP 200 and an Esri
    error body. The OpenAPI in this repo is derived by API Evangelist from live service and layer metadata - EPCOR publishes
    no specification.'
  humanURL: https://outages.epcor.com/
  baseURL: https://services6.arcgis.com/Ji2rusuWXDFSqNsP/ArcGIS/rest/services
  tags:
  - Outages
  - Geospatial
  - Electricity
  - Water
  - Open Data
  - Edmonton
  - Alberta
  - Arizona
  - New Mexico
  - ArcGIS
  properties:
  - type: OpenAPI
    url: openapi/epcor-outages-arcgis-openapi.yml
  - type: JSONSchema
    url: json-schema/epcor-outage-features.schema.json
  - type: Examples
    url: examples/epcor-power-outage-areas-query.json
  - type: Examples
    url: examples/epcor-arcgis-service-directory.json
  - type: Examples
    url: examples/epcor-water-canada-outages-query.json
  - type: Portal
    url: https://outages.epcor.com/
  - type: Standard
    url: https://developers.arcgis.com/rest/services-reference/enterprise/query-feature-service-layer/
  - type: AgentSkill
    url: skills/epcor-check-edmonton-power-outages.md
  - type: AgentSkill
    url: skills/epcor-track-water-outages-and-projects.md
  - type: AgentSkill
    url: skills/epcor-map-us-water-districts.md
common:
- type: AgenticAccess
  url: agentic-access/epcor-agentic-access.yml
- type: DomainSecurity
  url: security/epcor-domain-security.yml
- type: Authentication
  url: authentication/epcor-authentication.yml
- type: Conventions
  url: conventions/epcor-conventions.yml
- type: ErrorCatalog
  url: errors/epcor-problem-types.yml
- type: Lifecycle
  url: lifecycle/epcor-lifecycle.yml
- type: Conformance
  url: conformance/epcor-conformance.yml
- type: DataModel
  url: data-model/epcor-data-model.yml
- type: Packages
  url: packages/epcor-packages.yml
- type: LLMsTxt
  url: llms/epcor-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Website
  url: https://www.epcor.com/
- type: Website
  url: https://www.epcor.com/ca/en.html
- type: Website
  url: https://www.epcor.com/us/en.html
- type: LinkedIn
  url: https://www.linkedin.com/company/epcor
- type: Twitter
  url: https://twitter.com/epcor
- type: Facebook
  url: https://www.facebook.com/epcor
- type: Instagram
  url: https://www.instagram.com/epcor
- type: Portal
  url: https://customerportal.epcor.com/app/
- type: StatusPage
  url: https://outages.epcor.com/
- type: Support
  url: https://www.epcor.com/ca/en/ab/edmonton/contact-edmonton.html
- type: Blog
  url: https://www.epcor.com/ca/en/news.html
- type: PrivacyPolicy
  url: https://www.epcor.com/ca/en/about/policies/privacy-policy.html
- type: TermsOfService
  url: https://www.epcor.com/ca/en/about/policies/terms-of-use.html
- type: About
  url: https://www.epcor.com/Pages/about-epcor-ontario.aspx
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com