Developer Resources
For developers building a Data Custodian platform or Third Party app
Information for Developers will continue to be added as they are created. We are excited for the resources we will be providing you throughout 2025.
Please check-back soon and often for more content.
Table of Contents
Atom Elements Used in Green Button Files
Understanding the Atom Elements used with ESPI
Atom & ESPI Relationship
The relationship between Atom & ESPI for carrying Green Button Data
Cost and Currency Representations and Scaling
Understanding the scaling factor for representing decimal values of interval costs and their currency units
Daylight Savings Time & Time Zones
How to read/write a DST Offset in ESPI and determine the Time Zone
Generating Persistent UUIDs
Creating Version 5 Universally Unique Identifiers (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
Power-of-Ten Multiplier Scaling
When and how to apply and read sent values with a Multiplier attached
Usage-Point to Service-Location
Mapping Service-Location to a Metered Usage-Point
Utility-Bill Data Mapping
Mapping Utility Billing Data to the “Usage Summary” Resource XML Format