New information and developer resources are in development and will be provided throughout 2026.

Atom Elements Used in Green Button Files

Understanding the Atom Elements used with ESPI

Atom Elements

Atom & ESPI Relationship

The relationship between Atom & ESPI for carrying Green Button Data

Atom & ESPI

Cost and Currency Representations and Scaling

Understanding the scaling factor for representing decimal values of interval costs and their currency units

Cost and Currency

Daylight Savings Time & Time Zones

How to read/write a DST Offset in ESPI and determine the Time Zone

Daylight Savings Time

Generating Persistent UUIDs

Creating Version 5 Universally Unique Identifiers (UUIDs)

Generating UUIDs

Green Button - Application Programming Interface (API)

OAuth REST services provided by Data Custodians and Third-Party Applications

Green Button API   (opens into GBA’s GitHub Sandbox servers)

Green Button DMD Validator

Validate Green Button XML files to Atom & ESPI compliance

DMD Validator   (opens into GBA’s DMD Validator servers)

OAuth for Green Button Solutions

A series of articles describing how OAuth works for Green Button data

OAuth & Green Button

Power-of-Ten Multiplier Scaling

When and how to apply and read sent values with a Multiplier attached

Power-of-Ten Multiplier

Usage Point for Aggregated Data

Providing Aggregated Data through the use of the Usage-Point field

Usage Point for Aggregated Data

Usage Point to Service Location

Mapping a Service Location to a Metered Usage Point

Usage-Point Service Location

Utility-Bill Data Mapping

Mapping Utility Billing Data to the “Usage Summary” Resource XML Format

Utility-Bill Data Mapping