AESO

AESO Outage API

The Outage API from AESO — 1 operation(s) for outage.

GitHub OpenAPI

Operations 1

GET /outage Fetch all the outages affecting TTCs on interties/flowgates #

Documentation

📖
Documentation
https://www.aeso.ca/market/market-and-system-reporting/aeso-application-programming-interface-api/
📖
APIReference
https://developer-apim.aeso.ca/apis

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/aeso/refs/heads/main/openapi/aeso-outage-api-openapi.yml

Other Resources

🔗
Onboarding
https://www.aeso.ca/assets/downloads/external/api/API-Access-Instructions-APIM-API-Gateway.pdf

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/aeso-outage-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aeso-outage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Intertie Public Reports Outage API
  description: Intertie Public Reports
  contact:
    name: ITC Support
    url: http://itc.aeso.ca/
    email: info@aeso.ca
  version: v1
servers:
- url: https://apimgw.aeso.ca/public/itc
- url: https://gateway-apim.aeso.ca/public/itc
security:
- {}
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Outage
paths:
  /outage:
    get:
      operationId: getOutages
      summary: Fetch all the outages affecting TTCs on interties/flowgates
      description: Fetches 13 months of data at a time. The data is available after 09 Nov 2020.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutagesReport'
              examples:
                default:
                  value:
                    Outages:
                      Outage:
                      - element: string
                        affectedIntertieOrFlowgate:
                        - BC
                        toInLocalTime: string
                        fromInLocalTime: string
            application/xml:
              schema:
                $ref: '#/components/schemas/OutagesReport'
              examples:
                default:
                  value: "<OutagesReport>\n  <Outages>\n    <Outage>\n      <element>string</element>\n      <affectedIntertieOrFlowgate>BC</affectedIntertieOrFlowgate>\n      <toInLocalTime>string</toInLocalTime>\n      <fromInLocalTime>string</fromInLocalTime>\n    </Outage>\n  </Outages>\n</OutagesReport>"
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '405':
          description: Invalid method
        '500':
          description: Internal server error
        '503':
          description: Service unavailable
      parameters:
      - name: startDate
        in: query
        required: true
        description: 'Pass any date in history or future with format: yyyyMMdd e.g. 12Aug2020 will be 20200812. Fetches 13 months of data at a time. The data is available after 09 Nov 2020.'
        schema:
          $ref: '#/components/schemas/OutageGetRequest'
      - name: endDate
        in: query
        required: true
        description: 'Pass any date equal to or after startDate with format: yyyyMMdd e.g. 12Aug2020 will be 20200812. Fetches 13 months of data at a time. The data is available after 09 Nov 2020.'
        schema:
          $ref: '#/components/schemas/OutageGetRequest-1'
      - name: affectedIntertieOrFlowgate
        in: query
        required: false
        description: "Pass one value. No selection or '--' will select all interties and flowgates by default. \n\n_Available values_: BC, MATL, SK, BC_MATL"
        schema:
          $ref: '#/components/schemas/OutageGetRequest-2'
      tags:
      - Outage
components:
  schemas:
    OutageGetRequest-1:
      type: string
      description: As Of Date
      x-apim-inline: true
    OutageReport:
      type: object
      properties:
        Outage:
          type: array
          items:
            $ref: '#/components/schemas/OutageVO'
    OutageGetRequest-2:
      enum:
      - BC
      - MATL
      - SK
      - BC_MATL
      type: string
      description: start
      x-apim-inline: true
    OutagesReport:
      type: object
      properties:
        Outages:
          $ref: '#/components/schemas/OutageReport'
    OutageVO:
      type: object
      properties:
        element:
          type: string
        affectedIntertieOrFlowgate:
          uniqueItems: true
          type: array
          items:
            enum:
            - BC
            - MATL
            - BC_MATL
            - SK
            - SKEXP
            - NA
            type: string
        toInLocalTime:
          type: string
        fromInLocalTime:
          type: string
    OutageGetRequest:
      type: string
      description: As Of Date
      x-apim-inline: true
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: API-KEY
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
x-provenance:
  harvestedBy: API Evangelist
  harvestedOn: '2026-07-27'
  sourcePortal: https://developer-apim.aeso.ca/
  method: Assembled verbatim from the AESO Azure API Management developer-portal data API, which is served anonymously. AESO's own OpenAPI export (?export=true&format=openapi) returns a valid document with an EMPTY paths object, so paths, parameters, responses, examples and component schemas were read from the portal's operations/ and schemas/ endpoints and reassembled without alteration. Nothing was invented.
  sources:
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1?api-version=2022-04-01-preview
    status: 200
    note: API metadata
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1?export=true&format=openapi%2Bjson&api-version=2022-04-01-preview
    status: 200
    note: AESO OpenAPI export (empty paths) - basis for info/servers/security
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1/operations?api-version=2022-04-01-preview
    status: 200
    note: operation list
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1/schemas?api-version=2022-04-01-preview
    status: 200
    note: schema list
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1/operations/getOutages?api-version=2022-04-01-preview
    status: 200
    note: operation detail
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1/operations/getReportByRange?api-version=2022-04-01-preview
    status: 200
    note: operation detail
  - url: https://developer-apim.aeso.ca/developer/apis/itc-api-v1/schemas/675b1b263d594b1e2075ef55?api-version=2022-04-01-preview
    status: 200
    note: schema document