CMS Energy · OpenAPI Overlay 1.0.0

API Evangelist enhancements — Consumers Energy Green Button Connect My Data API (UtilityAPI) Authorizations Bills API

3 actions 3 updates update extends cms-energy-bills-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-api-evangelistx-operatorx-artifactsx-rate-limitx-error-envelope

Targets 3

$.info

$.paths..get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements — Consumers Energy Green Button Connect My Data API (UtilityAPI)
    Authorizations Bills API
  version: 1.0.0
extends: cms-energy-bills-api-openapi.yml
x-provenance:
  generated: '2026-09-06'
  method: generated
  source: openapi/cms-energy-bills-api-openapi.yml
  note: Captures API Evangelist additions only. The underlying OpenAPI is never mutated.
actions:
- target: $.info
  description: Attach API Evangelist provenance and operator attribution.
  update:
    x-api-evangelist:
      profile: https://apis.io/provider/cms-energy
      repository: https://github.com/api-evangelist/cms-energy
      note: Third-party profile. Not published or endorsed by CMS Energy.
    x-operator: UtilityAPI, under licence to Consumers Energy (CMS Energy). Consumers Energy designates
      https://utilityapi.com/docs/utilities/consumersenergy as the API documentation for its Green Button
      Connect My Data program from its own host https://greenbutton.consumersenergy.com/.
- target: $
  description: Link the derived and searched artifacts that describe runtime behaviour this spec does
    not carry.
  update:
    x-artifacts:
      conventions: conventions/cms-energy-conventions.yml
      errors: errors/cms-energy-problem-types.yml
      rateLimits: rate-limits/cms-energy-rate-limits.yml
      lifecycle: lifecycle/cms-energy-lifecycle.yml
      authentication: authentication/cms-energy-authentication.yml
      conformance: conformance/cms-energy-conformance.yml
      dataModel: data-model/cms-energy-data-model.yml
      agenticAccess: agentic-access/cms-energy-agentic-access.yml
- target: $.paths..get
  description: Record the published rate guidance and the exhaustion signal on read operations.
  update:
    x-rate-limit: 'Bill and interval downloads: 1/minute. All other GET/POST: 1/second. 429 carries Retry-After;
      202 means the payload is being built asynchronously.'
    x-error-envelope: error / error_description / url (not RFC 9457).

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/cms-energy-bills-api-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.