AEMO · OpenAPI Overlay 1.0.0

API Evangelist enhancements for System Management Reports v2.1

5 actions 5 updates update extends openapi/aemo-system-management-reports-v2-1-openapi.yml

Derived by API Evangelist Built from the contracts AEMO publishes. AEMO did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-enrichedx-apievangelist-artifactsx-apievangelist-sourcex-apievangelist-contractx-apievangelist-stylex-apievangelist-note

Targets 2

$.servers

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for System Management Reports v2.1
  version: 1.0.0
extends: openapi/aemo-system-management-reports-v2-1-openapi.yml
actions:
- target: $.servers
  description: Replace AEMO's internal api-prd.aemo.local server with the reachable production and pre-production
    gateway entry points AEMO documents at https://dev.aemo.com.au/oauth, combined with this API's published Azure
    API Management path.
  update:
  - url: https://api.aemo.com.au/WEM/sm
    description: Production e-Hub API gateway.
  - url: https://api.preprod.wgw.aemo.com.au/WEM/sm
    description: Pre-production e-Hub API gateway.
- target: $.info
  description: Record API Evangelist provenance and the enrichment artifacts that describe this API.
  update:
    x-apievangelist-provider: aemo
    x-apievangelist-enriched: '2026-07-27'
    x-apievangelist-artifacts:
      authentication: authentication/aemo-authentication.yml
      conventions: conventions/aemo-conventions.yml
      errors: errors/aemo-error-codes.yml
      lifecycle: lifecycle/aemo-lifecycle.yml
      rate_limits: rate-limits/aemo-rate-limits.yml
      conformance: conformance/aemo-conformance.yml
      vocabulary: vocabulary/aemo-glossary.yml
      agentic_access: agentic-access/aemo-agentic-access.yml
- target: $.info
  description: Bind this document to its source entry in AEMO’s Azure API Management catalogue.
  update:
    x-apievangelist-source:
      apim_api_id: system-management-reports-v2-1
      catalogue: https://dev.aemo.com.au/developer/apis?api-version=2022-04-01-preview
      operations: https://dev.aemo.com.au/developer/apis/system-management-reports-v2-1/operations?api-version=2022-04-01-preview
      reference: https://dev.aemo.com.au/api-docs
      gateway_path: WEM/sm
      note: AEMO’s openapi-link export ships an empty paths object; the operations, parameters, headers, responses
        and examples in this document were harvested from AEMO’s own developer-portal operations endpoints.
- target: $.info
  description: Record the measured contract shape of this document as harvested.
  update:
    x-apievangelist-contract:
      operations: 9
      operations_with_description: 0
      operations_with_response_examples: 9
      soap_action_operations: 9
      components_schemas: 0
      idempotency_key: false
- target: $.info
  description: Flag that this API is a SOAP pass-through exposed through Azure API Management.
  update:
    x-apievangelist-style: soap-passthrough
    x-apievangelist-note: Operations are differentiated by a soapAction query parameter on a shared base path, so
      path keys carry the literal APIM URL template. Payloads are aseXML inside a SOAP envelope.

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/aemo-system-management-reports-v2-1-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.