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

Check-back soon and often for more content.

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

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