# Green Button Alliance

**Canonical:** https://apis.io/providers/green-button-alliance/  
**Website:** https://www.greenbuttonalliance.org/  
**APIs profiled:** 3

The Green Button Alliance (GBA) is the non-profit that stewards, tests and certifies the Green Button standard — the NAESB REQ.21 Energy Services Provider Interface (ESPI) profile for utility customer electricity, natural gas and water usage data, in its Download My Data (DMD) and Connect My Data (CMD) forms. Incorporated in North Carolina and headquartered at PO Box 268, Jamison, Pennsylvania, it was formed after the 2012 White House / U.S. Department of Energy / NIST call to action and is the industry's only source of Green Button certification (Data Custodian DMD $3,000, CMD $3,200, membership not required), alongside a free public Directory Services listing of utilities, third-party apps and platform providers. GBA sits in the standards-and-certification layer of the United States energy value chain, above the investor-owned utilities and the energy-data platforms (UtilityAPI, Con Edison and Enbridge Gas are sponsor members) that actually move consumer data. Its API posture is contracts without a service: three real OpenAPI 3.x definitions - the CMD ESPI resource server, the ApplicationInformation registration resource, and the OpenESPI OAuth 2.0 / OIDC authorization server - are published free under Apache 2.0 on GitHub, but the normative ESPI v4.0 standard itself must be purchased from NAESB, GBA operates no production consumer-data or market-data API of its own, and its ESPI sandbox at sandbox.greenbuttonalliance.org:8443 is offline pending a replacement platform expected 2026Q3. Green Button in the United States is voluntary — there is no federal mandate — with obligation arriving only through state action and, outside the US, Ontario's O. Reg. 633/21.

## Kin Score — 53.6 / 100 (developing)

Scored 2026-08-17 under rubric 0.11.0. Trend: flat (+0.0 from 53.6).

| Facet | Score |
|---|---|
| Discoverability | 92.6 |
| Contract Quality | 60.3 |
| Governance | 31.3 |
| Operational Transparency | 23.7 |
| Developer Ergonomics | 51.6 |
| Commercial Clarity | 44.7 |

Regulatory layer — **Energy & Utilities**: 71.6 (matched via tags).

## Agent readiness — 48.2 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| MCP Server | derived |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | documented |
| OpenAPI Examples | documented |
| Rate Limit Signal | verified |
| Event Surface Described | yes |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## APIs (3)

- **Green Button Connect My Data (CMD) ESPI Resource Server API** — The Green Button Connect My Data resource server API as specified by the Green Button Alliance against NAESB REQ.21 ESPI 4.0 — read access to ApplicationInformation, Authorizati...
- **Green Button Third Party (OpenESPI) API** — The Third Party side of the OpenESPI reference implementation — ApplicationInformation, Authorization and RetailCustomer operations documented as legacy Swagger 1.2 resource lis...
- **Green Button Alliance OpenESPI Authorization Server API** — Green Button Alliance OpenESPI Authorization Server API from Green Button Alliance — 12 path(s) described in OpenAPI.

## MCP servers (1)

- **Candidate MCP tool surface (derived, not published)** — Green Button Alliance operates no MCP server. This is an API Evangelist candidate tool set derived from the operations in GBA's own OpenAPI documents.

## Agentic access (1)

- **Green Button Alliance Agentic Access** — 24 operations · 8 acting · 1 human-in-the-loop

## Security (3)

- **Green Button Alliance Authentication** — http/mutualTLS/oauth2/openIdConnect · 4 schemes
- **Green Button Alliance Domain Security** — TLSv1.3 · HSTS · DMARC
- **Green Button Alliance Vulnerability Disclosure** — Hackerone · security.txt · contact published

## Tags

Energy, United States, Utilities, Electricity, Gas, Water, Smart Metering, Green Button, ESPI, Standards Body, Certification, Consumer Energy Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/green-button-alliance/). Scores are computed from the provider's own public artifacts under a published rubric.