Green Button® Certification Program
Testing & Certification of Utility Usage-Data Sharing Platforms
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 Certified℠ DMD or Green Button Certified℠ CMD Certification mark denoting compliance to the standard.
Get the Latest Version of the Standard
Before you get tested, be sure you are using the latest version of the standard.
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 commonly referred to as 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
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 obtain the Green Button Certified CMD mark to show that their implementation is Green Button standards-compliant and that it will enable secure customer data-access; the 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 the market.
Note: Although our CMD Certification Testing program for Data Custodians (utilities and similar) is alive, our Green Button CMD Verification program for Third-Party service providers has been delayed until 2024. When available, details will be posted here.
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 or registration to use the tool:
If, after using the DMD Validator, 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.
An Important Note About the DMD Validator…
Although the DMD Validation Tool provides a pre-check of a Green Button DMD file to meet the NAESB REQ.21 Energy Service Provider Interface (ESPI) schema requirements, it does not test all the elements required to successfully complete the DMD Certification Testing scenario; as some of these cannot be automated.
The Green Button Data Custodian Download My Data (DMD) Test Data Sheet provides the detailed steps of the DMD Certification Testing session.
During the Certification Testing session, the Certification Examiner simulates being a utility customer and accesses the utility’s customer web portal—performing the steps a customer takes to download their Energy Usage Information. Additionally, the Examiner performs several visual inspections of the downloaded data to ensure they meet specific data requirements; ensuring the repeatability of the information and the customer’s privacy.
The DMD Validator, therefore, should only be one of several assurances used before scheduling a Certification Testing session with the GBA for your particular implementation.
Trademarks and Certification Marks
Use of the words “Green Button Certified” and/or the associated marks and/or Certified Word Marks, is restricted to use on advertising for those conforming products and implementations certified by the Green Button Alliance Certification Testing program. No use of language that includes the word, mark, or logo in connection with nonconforming implementations is allowed.
The use of any term such as “Green Button Certified” (regardless of language, capitalization, and hyphenation) may not be used at any time without the appropriate DMD, CMD, Download My Data, or Connect My Data addition, either to describe conforming or nonconforming implementations. The use of any terms such as, “Green Button Alliance compliant”, “Green Button Alliance compatible”, or “Green Button Alliance conforming” (regardless of language, capitalization, and hyphenation) may not be used at any time, either to describe conforming or nonconforming implementations. These prohibitions apply to all online presence, packaging, or collateral and advertising material related to conforming and nonconforming implementations.
Use of any Green Button Alliance logos, marks, or trademarked terms require the signing of a Logo License Agreement by GBA Members, non-Members, and those undergoing Green Button Certification Testing.
Contact Us for a digitally sign-able Green Button Logo License Agreement.
For more detail about compliance, see our online Green Button Certified℠ Marks Style Guide.
Certification alone dictates whether or not the Certified Word Marks, may be used.
Please see the Green Button Certified Marks Style Guide for more information on the usage of trademarks:
Benefits and Costs of Testing through the GBA
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.
- A Green Button Alliance DMD or CMD Certification 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.
Membership in the Green Button Alliance is not required for Certification but some Training & Education Time is provided to Members without additional cost (see below for details).
- Data Custodian, Download My Data Certification
(DC-DMD): USD $3000
- includes a single two-hour testing window
- Data Custodian, Connect My Data Certification
(DC-CMD): USD $3200
- includes a single two-hour testing window
- Data Custodian, Combination Download My Data & Connect My Data Certifications
(DC-DMD+DC-CMD): USD $3700
- includes a single two-hour testing window
- both DMD & CMD must be tested at the same time
- both DMD & CMD must use the same platform/engine
Additional Certification Testing time (i.e., an additional two-hour testing window) can be obtained for USD $2500 if required-changes cannot be made within the initial two-hour testing window of the Certification Test.
If you are not certain that you are ready to test, we offer a Pre-Certification Testing option at a fraction of the price: USD $250 per hour1.
The GBA offers Technical Education & Training customized for you to understand Green Button from a technical perspective. The GBA also offers a Pre-Certification Testing to prepare for the actual Certification Testing of your implementation (see above).
- Participating Members of the GBA receive two (2) hours of Technical Education & Training.
- Sponsor Members of the GBA receive ten (10) hours of Technical Education & Training.
- Technical Education & Training time is open to both Members and non-Members on an hourly basis as well. Presently, the rate is USD $250 per hour (one-hour minimum) and training/education is via telephone, email, and/or screen-sharing (Zoom, GTM, Teams, FCC, Meet, etc.) as needed. On-site training/education can also be provided at additional cost; contact us for details.