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