MISO · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Load, Generation, and Interchange API

3 actions 3 updates documentation extends openapi/miso-data-exchange-load-generation-interchange-api-openapi.json

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-aidx-apievangelist-artifactsx-apievangelist-access429403description

Targets 3

$.info

$.paths.*.get.responses

$.components.securitySchemes.apiKeyHeader

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Load, Generation, and Interchange API
  version: 1.0.0
extends: openapi/miso-data-exchange-load-generation-interchange-api-openapi.json
x-generated: '2026-07-27'
x-method: generated
actions:
- target: $.info
  update:
    x-apievangelist-provider: miso
    x-apievangelist-aid: miso:miso-data-exchange-load-generation-interchange-api
    x-apievangelist-artifacts:
      authentication: authentication/miso-authentication.yml
      conventions: conventions/miso-conventions.yml
      errors: errors/miso-problem-types.yml
      lifecycle: lifecycle/miso-lifecycle.yml
      rate-limits: rate-limits/miso-rate-limits.yml
      plans: plans/miso-plans.yml
      data-model: data-model/miso-data-model.yml
      agentic-access: agentic-access/miso-agentic-access.yml
      skills: skills/_index.yml
    x-apievangelist-access: self-serve-api-key
- target: $.paths.*.get.responses
  description: MISO enforces a 100 call/minute rate limit and a 24,000 call/day quota per subscription
    but declares neither status code on any operation. Added so generated clients handle throttling.
  update:
    '429':
      description: Too Many Requests — the subscription exceeded its 100 call/minute rate limit. No Retry-After
        header is published; back off at least 60 seconds.
    '403':
      description: Forbidden — the subscription exceeded its 24,000 call/day quota.
- target: $.components.securitySchemes.apiKeyHeader
  description: MISO declares the 401 on every operation as "Invalid or missing Bearer Token in the Authorization
    header", but the credential the gateway actually enforces is this subscription key. Recorded so the
    mismatch is not propagated to clients.
  update:
    description: MISO Data Exchange subscription key. Free and self-serve at https://data-exchange.misoenergy.org/
      with no approval step. Keys do not expire, but the MISO account they belong to requires a password
      reset every 12 months.

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/miso-data-exchange-lgi-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.