Free resources for developers of Green Button solutions —
for Data Custodians (Utilities) and Third Parties (App and Service Providers).

Green Button Standards

The Green Button data format and transport use over a dozen industry data formats and security standards.

Here are a few links to some of the most-relevant for developers getting started:

• • W3C XML -- Extensible Markup Language
  • IETF RFC 4287 -- The Atom Syndication Format
  • IETF RFC 6749 -- The OAuth 2.0 Authorization Framework
  • IETF RFC 6750 -- The OAuth 2.0 Authorization Framework: Bearer Token Usage
  • IETF RFC 7591 -- OAuth 2.0 Dynamic Client Registration Protocol
  • IETF RFC 7592 -- OAuth 2.0 Dynamic Client Registration Management Protocol
  • NAESB REQ.21 -- Energy Services Provider Interface (ESPI)

How to use the Standards

To assist developers in understanding the relationship between the standards, the GBA provides the following resources free of charge and without any registration.  It’s part of our nonprofit mission.

Accuracy and Reading Quality

Seeing how Quality of Reading flags are used to convey data-reading accuracy.

Accuracy & Reading Quality

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

New information and new developer resources will be provided throughout the year.