Hydro-Québec website screenshot

Hydro-Québec

Hydro-Québec is the government-owned Crown corporation that generates, transmits and distributes almost all of the electricity consumed in Québec, Canada — a vertically integrated, near-monopoly utility running one of the largest hydroelectric fleets in the world and serving roughly 4.6 million customer accounts across the province. It sits at every point of the value chain at once, as generator, transmission owner, distributor and retailer, plus a cross-border exporter into the New England and New York markets. Its API posture is a clean split. Market and grid data is genuinely open — a public Opendatasoft-powered portal at donnees.hydroquebec.com serves 26 datasets (electricity demand and generation, imports and exports, outages, GHG emission factors, hydrometric and weather data, winter peak demand events, vegetation control) through a documented, anonymously callable REST API with a machine-readable OpenAPI 3.0.3 description and a DCAT catalog export, licensed CC BY-NC 4.0. Consumer data is closed — there is no documented customer-facing API, no Green Button Download My Data or Connect My Data service, and no third-party consent flow; a customer's own usage is reachable only by logging into the Espace client web portal. Québec has no consumer energy data right. Ontario's Green Button regulation (O. Reg. 633/21 under the Electricity Act, 1998) is province-specific and does not bind Hydro-Québec, and Canada has no national equivalent to Australia's Consumer Data Right energy regime. Open market data, closed consumer data, no mandate.

Hydro-Québec publishes 2 APIs on the APIs.io network: Open Data Explore API v2.1 and Open Data Explore API v2.0. Tagged areas include Energy, Canada, Utilities, Electricity, and Grid.

Hydro-Québec’s developer surface includes authentication, developer portal, documentation, API reference, getting-started guide, support, engineering blog, and 30 more developer resources.

54.0/100 developing ▬ flat Agent 59/100 agent native Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
3 APIs 1 MCP Servers
EnergyCanadaUtilitiesElectricityGridEnergy MarketsRenewablesOpen DataDemand ResponseCarbon

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 54.0/100 · developing
Contract Quality 12.0 / 21
Developer Ergonomics 11.7 / 17
Commercial Clarity 3.6 / 17
Operational Transparency 7.9 / 11
Governance 1.2 / 10
Discoverability 7.9 / 9
Regulatory Posture 9.7 / 15
Agent readiness — 59/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 3 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 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/hydro-quebec: 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 3

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

Hydro-Québec Open Data Explore API v2.1

Read-only REST API over Hydro-Québec's 26 public open datasets — catalog search, dataset metadata, record query with the Opendatasoft Query Language (ODSQL), facets, attachments...

Hydro-Québec Open Data Explore API v2.0

The prior major version of the Hydro-Québec open data Explore API, still served alongside v2.1 at its own base path and described by its own OpenAPI 3.0.3 document (also mirrore...

Hydro-Québec Open Data Search API v1

The legacy Opendatasoft Search API v1 still served on the Hydro-Québec open data portal. Verified live and anonymous on 2026-07-27 — GET /api/datasets/1.0/search/ returned HTTP ...

Open Collections 2

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

Explore API

OPEN COLLECTION

Explore API

OPEN COLLECTION

MCP Servers 1

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

Rate Limits 1

Documented rate limits and quota policies.

Hydro Quebec Rate Limits

1 limits

RATE LIMITS

Security Posture 3

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

Hydro Quebec Authentication

none/apiKey/oauth2 · 3 schemes

SECURITY

Hydro Quebec Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Hydro Quebec Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Hydro Quebec Scopes

1 scope · authorizationCode

1 scopes

SCOPES

Agentic Access 1

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

Hydro Quebec Agentic Access

32 operations

32 operations · 0 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Scroll for all 7

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 6

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: hydro-quebec
url: https://raw.githubusercontent.com/api-evangelist/hydro-quebec/refs/heads/main/apis.yml
name: Hydro-Québec
kind: company
description: Hydro-Québec is the government-owned Crown corporation that generates, transmits and distributes almost all of
  the electricity consumed in Québec, Canada — a vertically integrated, near-monopoly utility running one of the largest hydroelectric
  fleets in the world and serving roughly 4.6 million customer accounts across the province. It sits at every point of the
  value chain at once, as generator, transmission owner, distributor and retailer, plus a cross-border exporter into the New
  England and New York markets. Its API posture is a clean split. Market and grid data is genuinely open — a public Opendatasoft-powered
  portal at donnees.hydroquebec.com serves 26 datasets (electricity demand and generation, imports and exports, outages, GHG
  emission factors, hydrometric and weather data, winter peak demand events, vegetation control) through a documented, anonymously
  callable REST API with a machine-readable OpenAPI 3.0.3 description and a DCAT catalog export, licensed CC BY-NC 4.0. Consumer
  data is closed — there is no documented customer-facing API, no Green Button Download My Data or Connect My Data service,
  and no third-party consent flow; a customer's own usage is reachable only by logging into the Espace client web portal.
  Québec has no consumer energy data right. Ontario's Green Button regulation (O. Reg. 633/21 under the Electricity Act, 1998)
  is province-specific and does not bind Hydro-Québec, and Canada has no national equivalent to Australia's Consumer Data
  Right energy regime. Open market data, closed consumer data, no mandate.
image: https://hydroquebec.opendatasoft.com/assets/theme_image/hq-logo.png
tags:
- Energy
- Canada
- Utilities
- Electricity
- Grid
- Energy Markets
- Renewables
- Open Data
- Demand Response
- Carbon
created: '2026-07-27'
modified: '2026-07-27'
enrichedAt: '2026-07-27'
specificationVersion: '0.19'
apis:
- aid: hydro-quebec:hydro-quebec-open-data-explore-api-v2-1
  name: Hydro-Québec Open Data Explore API v2.1
  description: Read-only REST API over Hydro-Québec's 26 public open datasets — catalog search, dataset metadata, record query
    with the Opendatasoft Query Language (ODSQL), facets, attachments, and bulk exports to CSV, Parquet, GPX and DCAT. Covers
    Québec electricity demand and generation, imports and exports, ongoing outages and planned service interruptions, direct
    GHG emission factors, hydrometric and weather history, winter peak demand events, and vegetation control planning. Verified
    callable anonymously with no API key (HTTP 200, 26 datasets returned, 2026-07-27); an optional apikey query parameter
    is supported for authenticated requests. Data is licensed CC BY-NC 4.0 (attribution, non-commercial). Market and grid
    data only — no individual customer consumption is exposed.
  humanURL: https://donnees.hydroquebec.com/api/v2/console
  baseURL: https://donnees.hydroquebec.com/api/explore/v2.1
  tags:
  - Open Data
  - Electricity
  - Grid
  - Energy Markets
  - Carbon
  properties:
  - type: OpenAPI
    url: openapi/hydro-quebec-open-data-explore-api-v2-1-openapi.json
  - type: Documentation
    url: https://www.hydroquebec.com/documents-data/open-data/
  - type: APIReference
    url: https://donnees.hydroquebec.com/api/v2/console
  - type: Portal
    url: https://donnees.hydroquebec.com/pages/accueil/
  - type: Licensing
    url: https://www.hydroquebec.com/documents-data/open-data/licence.html
  - type: Overlay
    url: overlays/hydro-quebec-open-data-explore-api-v2-1-overlay.yaml
- aid: hydro-quebec:hydro-quebec-open-data-explore-api-v2-0
  name: Hydro-Québec Open Data Explore API v2.0
  description: The prior major version of the Hydro-Québec open data Explore API, still served alongside v2.1 at its own base
    path and described by its own OpenAPI 3.0.3 document (also mirrored at /api/v2/swagger.json). Same 16 read-only endpoints
    — catalog, datasets, records, facets, attachments and exports — over the same 26 public datasets. Anonymously callable,
    optional apikey query parameter, CC BY-NC 4.0.
  humanURL: https://donnees.hydroquebec.com/api/v2/console
  baseURL: https://donnees.hydroquebec.com/api/explore/v2.0
  tags:
  - Open Data
  - Electricity
  - Grid
  - Energy Markets
  properties:
  - type: OpenAPI
    url: openapi/hydro-quebec-open-data-explore-api-v2-0-openapi.json
  - type: Documentation
    url: https://www.hydroquebec.com/documents-data/open-data/
  - type: APIReference
    url: https://donnees.hydroquebec.com/api/v2/console
  - type: Licensing
    url: https://www.hydroquebec.com/documents-data/open-data/licence.html
  - type: Overlay
    url: overlays/hydro-quebec-open-data-explore-api-v2-0-overlay.yaml
  - type: Deprecation
    url: https://help.opendatasoft.com/apis/ods-explore-v2/explore_v2.1.html#section/Introduction/v2.1-Changelog
- aid: hydro-quebec:hydro-quebec-open-data-search-api-v1
  name: Hydro-Québec Open Data Search API v1
  description: The legacy Opendatasoft Search API v1 still served on the Hydro-Québec open data portal. Verified live and
    anonymous on 2026-07-27 — GET /api/datasets/1.0/search/ returned HTTP 200 with all 26 datasets. Documented through the
    portal's interactive v1 API console. Hydro-Québec publishes no OpenAPI or Swagger description for this version (/api/v1/swagger.json
    returns HTTP 404), so no machine-readable contract was harvested for it.
  humanURL: https://donnees.hydroquebec.com/api/v1/console
  baseURL: https://donnees.hydroquebec.com/api/datasets/1.0
  tags:
  - Open Data
  - Electricity
  - Legacy
  properties:
  - type: APIReference
    url: https://donnees.hydroquebec.com/api/v1/console
  - type: Documentation
    url: https://www.hydroquebec.com/documents-data/open-data/
  - type: Licensing
    url: https://www.hydroquebec.com/documents-data/open-data/licence.html
common:
- type: AgenticAccess
  url: agentic-access/hydro-quebec-agentic-access.yml
- type: DomainSecurity
  url: security/hydro-quebec-domain-security.yml
- type: Authentication
  url: authentication/hydro-quebec-authentication.yml
- type: Website
  url: https://www.hydroquebec.com/
- type: Portal
  url: https://donnees.hydroquebec.com/pages/accueil/
- type: DeveloperPortal
  url: https://donnees.hydroquebec.com/pages/accueil/
- type: Documentation
  url: https://www.hydroquebec.com/documents-data/open-data/
- type: APIReference
  url: https://donnees.hydroquebec.com/api/v2/console
- type: GettingStarted
  url: https://help.opendatasoft.com/apis/ods-explore-v2/explore_v2.1.html#section/Getting-Started
- type: Support
  url: https://www.hydroquebec.com/sefco2016/en/open-data-contact-us.html
- type: Blog
  url: https://news.hydroquebec.com/en/
- type: TermsOfService
  url: https://www.hydroquebec.com/terms-confidentiality.html
- type: PrivacyPolicy
  url: https://www.hydroquebec.com/documents-data/act-respecting-access/protection-personal-information/
- type: Licensing
  url: https://www.hydroquebec.com/documents-data/open-data/licence.html
- type: LinkedIn
  url: https://www.linkedin.com/company/hydro-quebec
- type: Packages
  url: packages/hydro-quebec-packages.yml
- type: WellKnown
  url: well-known/hydro-quebec-well-known.yml
- type: SecurityTxt
  url: well-known/hydro-quebec-security.txt
- type: MCPServer
  url: mcp/hydro-quebec-mcp.yml
- type: ToolCrosswalk
  url: mcp/hydro-quebec-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/hydro-quebec-llms.txt
- type: Conformance
  url: conformance/hydro-quebec-conformance.yml
- type: ErrorCatalog
  url: errors/hydro-quebec-problem-types.yml
- type: Lifecycle
  url: lifecycle/hydro-quebec-lifecycle.yml
- type: StatusPage
  url: https://status.huwise.com/
- type: Deprecation
  url: https://help.opendatasoft.com/apis/ods-explore-v2/explore_v2.1.html#section/Introduction/v2.1-Changelog
- type: ChangeLog
  url: changelog/hydro-quebec-changelog.yml
- type: OAuthScopes
  url: scopes/hydro-quebec-scopes.yml
- type: Conventions
  url: conventions/hydro-quebec-conventions.yml
- type: Idempotency
  url: conventions/hydro-quebec-conventions.yml
- type: RateLimits
  url: rate-limits/hydro-quebec-rate-limits.yml
- type: Sandbox
  url: sandbox/hydro-quebec-sandbox.yml
- type: Components
  url: components/hydro-quebec-components.yml
- type: DataModel
  url: data-model/hydro-quebec-data-model.yml
- type: VulnerabilityDisclosure
  url: security/hydro-quebec-vulnerability-disclosure.yml
- type: Security
  url: https://donnees.hydroquebec.com/.well-known/security.txt
- type: AgentSkill
  url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com