Ontario Energy Board website screenshot

Ontario Energy Board

The Ontario Energy Board (OEB) is the independent regulator of Ontario's electricity and natural gas sectors, licensing and rate-regulating roughly 60 electricity distributors, the province's transmitters, storage and generation licensees, unit sub-meter providers, energy retailers and gas marketers, and Enbridge Gas. It sits above the wires-and-pipes layer of Canada's largest provincial energy market — it does not own assets, does not run the wholesale market (that is IESO) and holds no customer meter data — so everything it publishes is regulatory, rate and utility-performance data rather than consumption data. Its API posture is the sharpest consumer-versus-market split this series has recorded in Canada. On market data it is genuinely open — an Open Data programme launched September 2022 under Ontario's Digital and Data Directive publishes 40 datasets - 198 individual files, verified by crawl on 2026-07-27; the programme's own earlier count was 18 - as anonymous, key-free XML, XLSX and GIS files under the Open Government Licence – Ontario, covering every open application before the Board (updated daily), current electricity and natural gas rates, distributor service-territory boundaries, the distributor performance scorecard, consumer complaints, and thirteen Reporting and Record-keeping Requirements (RRR) filings series going back to 2015. On consumer data it publishes nothing at all, because it holds nothing — it is instead the supervisor of the consumer-data mandate. Ontario is the only Canadian jurisdiction with a compulsory energy-data-sharing rule — O. Reg. 633/21 (Energy Data) under the Electricity Act, 1998 required rate-regulated electricity and natural gas utilities to implement Green Button Download My Data and Connect My Data to NAESB REQ.21 ESPI v3.3 by 1 November 2023 — and the OEB is the body that ran the consultation (EB-2021-0183), amended the Retail Settlement Code, collected quarterly progress reports and publishes the implementation status register naming 54 confirmed distributors and 6 extensions. There is no developer portal, no OpenAPI, no API key and no signup — just files, plus an undocumented but live JSON output on the regulatory document search.

Ontario Energy Board publishes 2 APIs on the APIs.io network: OEB Open Data and OEB Regulatory Document Search (RDS). Tagged areas include Energy, Canada, Ontario, Utilities, and Electricity.

Ontario Energy Board’s developer surface includes documentation, developer portal, support, engineering blog, authentication, changelog, and 22 more developer resources.

47.1/100 developing ▬ flat Agent 38/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
2 APIs 1 MCP Servers
EnergyCanadaOntarioUtilitiesElectricityGasGreen ButtonSmart MeteringEnergy MarketsRegulatorOpen DataGrid

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 47.1/100 · developing
Contract Quality 11.8 / 21
Developer Ergonomics 8.0 / 17
Access Clarity 4.9 / 17
Operational Transparency 1.7 / 11
Contract Governance 4.6 / 10
Discoverability 6.5 / 9
Regulatory Posture 5.9 / 15
Agent readiness — 38/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 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 7 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 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/ontario-energy-board: 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.

OEB Open Data

The Ontario Energy Board's Open Data programme, launched September 2022 under Ontario's Digital and Data Directive (2021) and expanded in October 2023 ("Open Data 2.0") and Augu...

OEB Regulatory Document Search (RDS)

The OEB's public regulatory document search, serving every filing, decision, order, licence, code amendment and piece of correspondence in the Board's case record. It runs on Mi...

Open Collections 2

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

OEB Open Data

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

JSON Schema 1

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

OEB RDS record search response

11 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Security Posture 2

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

Ontario Energy Board Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 9

Reference material describing how the API behaves

Scroll for all 9

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

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 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: ontario-energy-board
url: https://raw.githubusercontent.com/api-evangelist/ontario-energy-board/refs/heads/main/apis.yml
name: Ontario Energy Board
kind: company
description: The Ontario Energy Board (OEB) is the independent regulator of Ontario's electricity and natural gas sectors,
  licensing and rate-regulating roughly 60 electricity distributors, the province's transmitters, storage and generation licensees,
  unit sub-meter providers, energy retailers and gas marketers, and Enbridge Gas. It sits above the wires-and-pipes layer
  of Canada's largest provincial energy market — it does not own assets, does not run the wholesale market (that is IESO)
  and holds no customer meter data — so everything it publishes is regulatory, rate and utility-performance data rather than
  consumption data. Its API posture is the sharpest consumer-versus-market split this series has recorded in Canada. On market
  data it is genuinely open — an Open Data programme launched September 2022 under Ontario's Digital and Data Directive publishes
  40 datasets - 198 individual files, verified by crawl on 2026-07-27; the programme's own earlier count was 18 - as anonymous,
  key-free XML, XLSX and GIS files under the Open Government Licence – Ontario, covering every open application before the
  Board (updated daily), current electricity and natural gas rates, distributor service-territory boundaries, the distributor
  performance scorecard, consumer complaints, and thirteen Reporting and Record-keeping Requirements (RRR) filings series
  going back to 2015. On consumer data it publishes nothing at all, because it holds nothing — it is instead the supervisor
  of the consumer-data mandate. Ontario is the only Canadian jurisdiction with a compulsory energy-data-sharing rule — O.
  Reg. 633/21 (Energy Data) under the Electricity Act, 1998 required rate-regulated electricity and natural gas utilities
  to implement Green Button Download My Data and Connect My Data to NAESB REQ.21 ESPI v3.3 by 1 November 2023 — and the OEB
  is the body that ran the consultation (EB-2021-0183), amended the Retail Settlement Code, collected quarterly progress reports
  and publishes the implementation status register naming 54 confirmed distributors and 6 extensions. There is no developer
  portal, no OpenAPI, no API key and no signup — just files, plus an undocumented but live JSON output on the regulatory document
  search.
image: https://www.oeb.ca/themes/de_theme/logo.svg
tags:
- Energy
- Canada
- Ontario
- Utilities
- Electricity
- Gas
- Green Button
- Smart Metering
- Energy Markets
- Regulator
- Open Data
- Grid
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: ontario-energy-board:oeb-open-data
  name: OEB Open Data
  description: The Ontario Energy Board's Open Data programme, launched September 2022 under Ontario's Digital and Data Directive
    (2021) and expanded in October 2023 ("Open Data 2.0") and August 2024. A crawl of both pages of the programme index on
    2026-07-27 found 40 datasets linking 198 individual files (the earlier round recorded 18 datasets), all directly downloadable,
    anonymous, key-free files — no registration, no application, no rate limit and no terms click-through — under the Open
    Government Licence – Ontario. The largest share is XML — the daily-refreshed register of every open application before
    the Board, three monthly/quarterly rate files that back the OEB's own bill calculator, twelve annual electricity distributor
    performance scorecard files (2013-2024), ten annual consumer complaint files, and thirteen Reporting and Record-keeping
    Requirements (RRR) series covering system reliability, service quality, major event response, billing accuracy, LEAP low-income
    assistance, customers and connections, labour, capital, supply and delivery, demand and revenue, utility characteristics
    and regulated return on equity, each published as separate current, 2015-2021, 2023 and 2024 files. Distributor service-territory
    boundaries ship as GIS ZIP archives for electricity and natural gas. This is not a query API — there is no base path,
    no parameters, no pagination and no machine-readable contract of any kind. It is a set of stable, versioned, anonymously
    fetchable files with a published guide for importing the XML into Excel. Verified live on 2026-07-27, every URL below
    returning HTTP 200.
  humanURL: https://www.oeb.ca/open-data
  tags:
  - Open Data
  - Energy
  - Electricity
  - Gas
  - Rates
  - Utility Performance
  - Regulatory
  - XML
  - GIS
  properties:
  - type: Documentation
    url: https://www.oeb.ca/open-data
  - type: GettingStarted
    url: https://www.oeb.ca/sites/default/files/Open-Data-Guide-XML-Excel-20221215.pdf
  - type: ContentLicense
    url: https://www.ontario.ca/page/open-government-licence-ontario
  - type: Reference
    url: https://www.ontario.ca/page/ontarios-digital-and-data-directive-2021
  - type: Documentation
    url: https://www.oeb.ca/sites/default/files/OEBltr-Transition-to-Open-Data-20220929.pdf
  - type: Documentation
    url: https://www.oeb.ca/sites/default/files/OEB-Letter-Open-Data-2.0-20231006.pdf
  - type: Documentation
    url: https://www.oeb.ca/sites/default/files/OEB-letter-open-data-20240827.pdf
  - type: Documentation
    url: https://www.oeb.ca/open-data/applications-oeb
  - type: Dataset
    url: https://www.oeb.ca/_html/xml/all_open_appl_Cases_v2_reportFile.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/current-electricity-rates-residential-rate-class
  - type: Dataset
    url: https://www.oeb.ca/_html/calculator/data/BillData.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/current-electricity-rates-general-service-50-kw-rate-class
  - type: Dataset
    url: https://www.oeb.ca/_html/calculator/data/BillData_GS.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/current-natural-gas-rates-residential-rate-classes
  - type: Dataset
    url: https://www.oeb.ca/_html/calculator/data/GasBillData.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-and-natural-gas-distributors-service-areas
  - type: Dataset
    url: https://www.oeb.ca/documents/opendata/open-data-electricity-map-20260429.zip
  - type: Dataset
    url: https://www.oeb.ca/documents/opendata/open-data-naturalgas-map-20260225.zip
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-distributor-performance-scorecard
  - type: Dataset
    url: https://www.oeb.ca/_html/performance/data/scorecard_data_2024.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-distributor-complaints-received-oeb
  - type: Dataset
    url: https://www.oeb.ca/_html/performance/data/complaints_data_2022.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-distribution-rates-databases
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2142-system-reliability
  - type: Dataset
    url: https://www.oeb.ca/documents/opendata/rrr/2.1.4.2%20System%20Reliability%20Indicators.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2141-reporting-service
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-214210-major-event-response
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2119-billing-accuracy
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2116-low-income-energy
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-212-market-monitoring
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2151-labour
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2152-capital
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2153-supply-and-delivery
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2154-demand-and-revenue
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2155-utility
  - type: Documentation
    url: https://www.oeb.ca/open-data/electricity-reporting-record-keeping-requirements-rrr-section-2156-regulated-return
  - type: OpenAPI
    url: openapi/ontario-energy-board-open-data-openapi.yml
  - type: Overlay
    url: overlays/ontario-energy-board-open-data-overlay.yaml
  - type: DataModel
    url: data-model/ontario-energy-board-data-model.yml
  - type: AgentSkill
    url: skills/ontario-energy-board-pull-open-data.md
  - type: Documentation
    url: https://www.oeb.ca/open-data/licensed-market-participants
  - type: Dataset
    url: https://www.oeb.ca/_html/xml/all_Licences_report_File.xml
  - type: Documentation
    url: https://www.oeb.ca/open-data/historical-regulated-price-plan-electricity-rates
  - type: Documentation
    url: https://www.oeb.ca/open-data/intervenor-cost-awards
  - type: Documentation
    url: https://www.oeb.ca/ontarios-energy-sector/open-data?page=1
  baseURL: https://www.oeb.ca
- aid: ontario-energy-board:oeb-regulatory-document-search
  name: OEB Regulatory Document Search (RDS)
  description: The OEB's public regulatory document search, serving every filing, decision, order, licence, code amendment
    and piece of correspondence in the Board's case record. It runs on Micro Focus / OpenText Content Manager WebDrawer, and
    the OEB links directly to parameterised query URLs of the form /CMWebDrawer/Record?q=CaseNumber=EB-2021-0183&sortBy=recRegisteredOn-&pageSize=400
    from its own website — the licensed-companies list alone links hundreds of them. Fetched anonymously on 2026-07-27, this
    surface also honours a `format=json` parameter and returns application/json — a Content Manager ServiceAPIModel payload
    with Results, TotalResults, Count, HasMoreItems and typed Fields including CaseNumber, SIDocumentType, Applicant, EnergyType,
    PrimaryApplicationType and DateIssued — while /CMWebDrawer/Record/{uri}/File/document returns the underlying PDF. IMPORTANT
    — the OEB publishes no API reference, no base-URI statement, no query-syntax documentation, no OpenAPI and no terms for
    this interface; the JSON output is default behaviour of the underlying WebDrawer product, not a product the OEB documents
    or supports. It is recorded here because it was verified live and anonymous, not because it is an offered API. No key,
    no signup, no rate-limit policy published.
  humanURL: https://www.oeb.ca/rds
  baseURL: https://www.rds.oeb.ca/CMWebDrawer
  tags:
  - Regulatory
  - Document Search
  - Filings
  - Decisions
  - Licences
  - Undocumented
  properties:
  - type: Documentation
    url: https://www.oeb.ca/rds
  - type: Reference
    url: https://www.rds.oeb.ca/CMWebDrawer/Record?q=CaseNumber=EB-2021-0183&sortBy=recRegisteredOn-&pageSize=400
  - type: Documentation
    url: https://www.oeb.ca/ontarios-energy-sector/list-licensed-companies
  - type: OpenAPI
    url: openapi/ontario-energy-board-rds-openapi.yml
  - type: Overlay
    url: overlays/ontario-energy-board-rds-overlay.yaml
  - type: JSONSchema
    url: json-schema/ontario-energy-board-rds-record-search-response.json
  - type: Examples
    url: examples/ontario-energy-board-rds-record-search-response.json
  - type: Vocabulary
    url: vocabulary/ontario-energy-board-rds-search-clauses.yml
  - type: ErrorCatalog
    url: errors/ontario-energy-board-problem-types.yml
  - type: Authentication
    url: authentication/ontario-energy-board-authentication.yml
  - type: AgentSkill
    url: skills/ontario-energy-board-track-case-filings.md
  - type: AgentSkill
    url: skills/ontario-energy-board-verify-green-button-mandate.md
common:
- type: MCPServer
  url: mcp/ontario-energy-board-mcp.yml
- type: DomainSecurity
  url: security/ontario-energy-board-domain-security.yml
- type: Website
  url: https://www.oeb.ca/
- type: Documentation
  url: https://www.oeb.ca/open-data
- type: Portal
  url: https://www.oeb.ca/open-data
- type: ContentLicense
  url: https://www.ontario.ca/page/open-government-licence-ontario
- type: Reference
  url: https://www.oeb.ca/green-button
- type: Reference
  url: https://www.oeb.ca/consultations-and-projects/policy-initiatives-and-consultations/green-button-implementation
- type: Reference
  url: https://www.oeb.ca/consultations-and-projects/policy-initiatives-and-consultations/green-button-industry-led-working
- type: Reference
  url: https://www.oeb.ca/sites/default/files/Green-Button-implementation-status-summary.pdf
- type: Reference
  url: https://www.oeb.ca/ontarios-energy-sector/list-licensed-companies
- type: Reference
  url: https://www.oeb.ca/ontarios-energy-sector/performance-assessment/interactive-dashboards
- type: Support
  url: https://www.oeb.ca/contact-ontario-energy-board
- type: Blog
  url: https://www.oeb.ca/newsroom
- type: Reference
  url: https://www.oeb.ca/about-oeb/mission-and-mandate
- type: Authentication
  url: authentication/ontario-energy-board-authentication.yml
- type: Conventions
  url: conventions/ontario-energy-board-conventions.yml
- type: Conformance
  url: conformance/ontario-energy-board-conformance.yml
- type: Lifecycle
  url: lifecycle/ontario-energy-board-lifecycle.yml
- type: ChangeLog
  url: changelog/ontario-energy-board-changelog.yml
- type: ErrorCatalog
  url: errors/ontario-energy-board-problem-types.yml
- type: DataModel
  url: data-model/ontario-energy-board-data-model.yml
- type: Vocabulary
  url: vocabulary/ontario-energy-board-rds-search-clauses.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/ontario-energy-board-llms.txt
- type: PrivacyPolicy
  url: https://www.oeb.ca/legal-privacy-statements
- type: Accessibility
  url: https://www.oeb.ca/accessibility-ontario-energy-board
- type: Reference
  url: https://www.oeb.ca/sites/default/files/Open-Data-Guide-XML-Excel-20221215.pdf
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com