Green Button Alliance

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 listings served from GBA's GitHub Pages site. The documented base path is https://services.greenbuttondata.org/ThirdParty, which returned HTTP 200 with an empty body on 2026-07-27. No OpenAPI 3.x definition of this surface was found and no live, callable service was confirmed; listed here because the documentation is genuinely published and reachable.

GitHub

Documentation

📖
APIReference
https://greenbuttonalliance.github.io/OpenESPI-GreenButton-API-Documentation/ThirdParty/

Other Resources

🔗
Repository
https://github.com/GreenButtonAlliance/OpenESPI-ThirdParty-java
🔗
Repository
https://github.com/GreenButtonAlliance/OpenESPI-Common-java

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/green-button-third-party-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

API entry from apis.yml

apis.yml Raw ↑ 
aid: green-button-alliance:green-button-third-party-api
name: Green Button Third Party (OpenESPI) API
description: The Third Party side of the OpenESPI reference implementation — ApplicationInformation, Authorization
  and RetailCustomer operations documented as legacy Swagger 1.2 resource listings served from GBA's GitHub
  Pages site. The documented base path is https://services.greenbuttondata.org/ThirdParty, which returned
  HTTP 200 with an empty body on 2026-07-27. No OpenAPI 3.x definition of this surface was found and no
  live, callable service was confirmed; listed here because the documentation is genuinely published and
  reachable.
humanURL: https://greenbuttonalliance.github.io/OpenESPI-GreenButton-API-Documentation/ThirdParty/
baseURL: https://services.greenbuttondata.org/ThirdParty
tags:
- Green Button
- Third-Party
- ESPI
- Energy
- Reference Implementation
tags_raw:
- Green Button
- Third Party
- ESPI
- Energy
- Reference Implementation
properties:
- type: APIReference
  url: https://greenbuttonalliance.github.io/OpenESPI-GreenButton-API-Documentation/ThirdParty/
- type: Repository
  url: https://github.com/GreenButtonAlliance/OpenESPI-ThirdParty-java
- type: Repository
  url: https://github.com/GreenButtonAlliance/OpenESPI-Common-java