Green Button Testing & Verification Program

The Green Button Alliance offers the industry’s only Green Button Connect My Data® (CMD) and Green Button Download My Data® (DMD) Testing Programs for electricity, natural gas, and water utilities (“data custodians”).  The Green Button Alliance (GBA) administers the Green Button Testing Program and can help utilities prepare their implementations for testing and standards compliance.

Testing is performed remotely, online, and takes just a few hours.  Once a data custodian’s implementation has been tested and shown to be Green Button standards-compliant, the GBA issues the Green Button DMD or CMD testing mark denoting compliance to the standard.

 Back to top  

Get the Latest Version of the Standard

Before you get tested, be sure you are using the latest version of the standard that serves as the basis of the Green Button ecosystem.

On 2019-04-08, the North American Energy Standards Board (NAESB) ratified the enhancements to the Energy Service Provider Interface (ESPI) Retail Energy Quadrant Book 21 (REQ.21) standard… “The Green Button Standard”:

  • Replaced OAuth 1.0 with OAuth 2.0 for “Confidential Clients”
  • Updated security requirements to TLS 1.2 as a minimum
  • Revised the Energy Usage Information (EUI) data structure and definitions
  • Created the Retail Customer (PII) data structure and definitions
  • Deprecated original Use Cases that do not meet OAuth 2.0 data security requirements
  • Added Use Case for Download My Data (DMD)
  • Simplified Use Case 2: “Customer Authorization process”
  • Documented Standard ESPI Application Program Interface (API) formats
Order your new copy of the standard here…

NAESB ESPI Standard...



 Back to top  

Green Button Connect My Data (CMD) Testing

Green Button Connect My Data (CMD) is the industry standard for accessing and securely sharing energy- and water-usage data.  Utilities developing customer data access-and-sharing implementations can now obtain the Green Button CMD mark to show that their implementation is Green Button standards-compliant and that it will enable secure customer data-access; customer-authorized, automatic and secure transmission of data to third-party solutions; and will ensure customer privacy.  Green Button Testing verifies for the utility, its customers, and third-party solution providers, that the standard has been properly implemented.  Testing also speeds reliable and compatible solutions to market.

“Green Button Connect My Data (CMD)” Data Sheet
Apply for Green Button CMD Testing (DOC)

Note: Our Green Button CMD Verification program for Third Party vendors will be available in 2020.

 Back to top  


Green Button Download My Data (DMD) Testing

The Green Button Download My Data (DMD) standard enables utility customers (residential, commercial, energy managers, etc.) to manually download their electricity-, natural gas-, or water-usage data from an energy or water provider’s website in an industry-standard XML data file format that can be opened by software applications of their choosing.  Customers can utilize these data to view their historical and present energy usage, analyze trends, and make informed choices about their consumption.  Utilities (“data custodians”) can apply to have their Green Button DMD solution tested.  If you are a utility (“data custodian”) that already has a Green Button Download My Data solution, you can pre-check your existing Green Button DMD files using the GBA’s Green Button DMD File Validator.  Pre-checking takes just a few minutes and there is no cost to confirm the files meet our testing requirements.

Green Button DMD Validation Tool

If you find your DMD solution is not standards-compliant, contact the GBA for assistance and suggested “next steps” to ensure your solution is ready for Green Button Alliance DMD Testing.

Apply for Green Button DMD Testing (DOC)

 Back to top  

Benefits of Testing through the Green Button Alliance

  • Assures utilities (data custodians) they’ve implemented the standard correctly and their solution will provide consistent, reliable data and work with other Green Button data-enabled solutions.
  • Speeds data-sharing implementation time-to-market and assures a seamless and secure data-sharing experience for customers.
  • Ensures utilities and their customers are gaining the full functionality and capabilities of the standard—see “Green Button Connect My Data (CMD)” Data Sheet, above.
  • Green Button standards ensure secure transmission of data and customer privacy, thus well-positioning utilities to meet regulations for customer privacy.
  • A Green Button Alliance DMD or CMD testing mark on the data custodian’s site signifies the solution has been tested to be standards-compliant; and a listing in the GBA database helps promote tested solutions to a broader audience.

 Back to top