Western Power Outages API

openapi: 3.2.0
info:
  title: Western Power Outage Web Outages API
  version: 2026.7.7.1
  description: The undocumented but anonymous first-party JSON API that backs the public Western Power outage tracker at westernpower.com.au/outages/. The outage page declares its own endpoints in markup — `all-outages-endpoint="/api/corp/outage/all-outages"` and `single-outage-endpoint="/api/corp/outage/details/"` — and both answer unauthenticated HTTPS GET requests with `application/json`. Western Power publishes no developer portal, no reference documentation, no terms of use and no SLA for this surface. This description was DERIVED BY API EVANGELIST from live probes on 2026-07-27; it is not published by Western Power, and the provider may change or withdraw these endpoints without notice.
  x-apievangelist-provenance:
    method: derived
    derived_by: API Evangelist
    derived_from: live HTTP probes of https://www.westernpower.com.au/api/corp/outage/*
    probe_date: '2026-07-27'
    provider_published: false
    note: Every path, parameter, status code and response field below was observed in a real HTTP response. Nothing here is inferred from vendor documentation, because none exists.
  contact:
    name: Western Power
    url: https://www.westernpower.com.au/contact-us/
  x-version-header: The site returns an AssemblyFileVersion/Build Number comment (2026.7.7.1 on 2026-07-27) in its HTML; the API itself carries no version identifier.
servers:
- url: https://www.westernpower.com.au/api/corp/outage
  description: Production (Cloudflare-fronted, anonymous)
tags:
- name: Outages
  description: Live planned and unplanned outage data for the South West Interconnected System.
paths:
  /all-outages:
    get:
      tags:
      - Outages
      operationId: listAllOutages
      summary: List all current and upcoming outages
      description: Returns every outage record the outage tracker plots — planned (`F`) and unplanned (`U`) — as a flat JSON array with no pagination and no envelope. Observed 211 records and a 61 KB payload on 2026-07-27. Takes no parameters.
      responses:
        '200':
          description: Array of outage summary records.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OutageSummary'
              example:
              - outageId: INCD-2015011-U
                outageType: F
                startTime: 20260728T190000+08:00
                restorationTime: 20260729T050000+08:00
                onMap: true
                outageUpdatedTime: 20260718T160020+00:00
                affectedCustomers: 126
                areas:
                - BOORAGOON
                latitudeCentroid: -32.03583
                longitudeCentroid: 115.83067
  /details/{outageId}:
    get:
      tags:
      - Outages
      operationId: getOutageDetails
      summary: Get one outage with tracker presentation detail
      description: Returns the full outage record plus the content the tracker renders around it — related FAQ links, the add-to-calendar modal copy, an update `historyGroup`, and bushfire / total-fire-ban / weather / fire-weather-warning impact flags. An unknown identifier returns HTTP 204 with an empty body rather than 404.
      parameters:
      - name: outageId
        in: path
        required: true
        description: Outage identifier as returned by `listAllOutages`, e.g. `INCD-2015011-U`.
        schema:
          type: string
      responses:
        '200':
          description: Outage detail record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutageDetail'
        '204':
          description: No content — the identifier did not match an outage. Observed for `/details/NOPE-123` on 2026-07-27.
  /status/{suburb}:
    get:
      tags:
      - Outages
      operationId: getSuburbOutageStatus
      summary: Get outage counts for a suburb
      description: Returns a rolled-up outage status for a suburb name — in-flight, resolved and planned counts, affected customers, and a human-readable restoration or planned-outage message. Accepts a comma-separated list, of which the client uses the first value. Unmatched names return zeroed counts with the submitted name title-cased in `suburb`, never an error status.
      parameters:
      - name: suburb
        in: path
        required: true
        description: Suburb name, e.g. `BOORAGOON`. Case-insensitive.
        schema:
          type: string
      responses:
        '200':
          description: Suburb outage status rollup.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuburbOutageStatus'
components:
  schemas:
    SuburbOutageStatus:
      type: object
      properties:
        errorMessage:
          type:
          - string
          - 'null'
          description: The only error channel this API exposes. Observed null on every probe; HTTP status stays 200 regardless of whether the suburb matched.
        suburb:
          type:
          - string
          - 'null'
          description: Echo of the submitted suburb, title-cased.
        inflightOutageCount:
          type: integer
        resolvedOutageCount:
          type: integer
        affectedCustomers:
          type: integer
        outageId:
          type:
          - string
          - 'null'
        restorationTimeFormatted:
          type:
          - string
          - 'null'
        restoredOutageId:
          type:
          - string
          - 'null'
        resolvedRestorationTimeFormatted:
          type:
          - string
          - 'null'
        plannedOutageCount:
          type: integer
        plannedOutageId:
          type:
          - string
          - 'null'
        plannedOutageTimeFormatted:
          type:
          - string
          - 'null'
          description: Human-readable sentence, e.g. "There are multiple planned outages in your area in the next ten days."
        inflightPlannedOutageCount:
          type: integer
        inflightUnPlannedOutagesCount:
          type: integer
    OutageSummary:
      type: object
      description: One outage as plotted on the public outage map.
      properties:
        outageId:
          type: string
          description: Incident reference, e.g. `INCD-2015011-U`.
        outageType:
          type: string
          description: Observed values `F` (planned/future works, 208 of 211 records on 2026-07-27) and `U` (unplanned, 3 records). Western Power publishes no code list; these are the only values seen.
          examples:
          - F
          - U
        startTime:
          type: string
          description: Outage start, basic-format ISO 8601 with AWST offset, e.g. `20260728T190000+08:00`.
        restorationTime:
          type: string
          description: Estimated restoration, same format as `startTime`.
        onMap:
          type: boolean
          description: Whether the outage is plotted on the public map.
        outageUpdatedTime:
          type: string
          description: Last update, basic-format ISO 8601, observed in UTC (`+00:00`).
        affectedCustomers:
          type: integer
          description: Number of customers impacted.
        areas:
          type: array
          description: Affected suburb / locality names, upper case.
          items:
            type: string
        latitudeCentroid:
          type: number
          format: double
        longitudeCentroid:
          type: number
          format: double
      required:
      - outageId
      - outageType
      - startTime
      - restorationTime
      - onMap
      - outageUpdatedTime
      - affectedCustomers
      - areas
      - latitudeCentroid
      - longitudeCentroid
    OutageDetail:
      type: object
      description: '`OutageSummary` plus the presentation payload the tracker renders. Content fields carry HTML strings and may be null.'
      allOf:
      - $ref: '#/components/schemas/OutageSummary'
      properties:
        moreInformationList:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
              url:
                type: string
        calendarModal:
          type: object
          description: Add-to-calendar modal copy and steps.
        extendedOutageCurrent:
          type: boolean
        historyGroup:
          type: array
          description: Dated update history for the outage.
          items:
            type: object
        tags:
          type: array
          items:
            type: string
        mayBeImpactedByBushfire:
          type: boolean
        mayBeImpactedByTotalFireBan:
          type: boolean
        mayBeImpactedByWeather:
          type: boolean
        mayBeImpactedByFireWeatherWarning:
          type: boolean
        bushfireCoordinates:
          type: array
          items:
            type: object
        activeIncidentsThatMayImpactOutageHeading:
          type:
          - string
          - 'null'
        activeIncidentsThatMayImpactOutageDescription:
          type:
          - string
          - 'null'
        activeIncidentsViewMoreLabel:
          type:
          - string
          - 'null'
        activeIncidentsViewMoreUrl:
          type:
          - string
          - 'null'
        fireWeatherWarningTagToMatch:
          type:
          - string
          - 'null'