---
title: "Green Button explained: ESPI energy data sharing | Quantlix"
description: "Green Button lets utility customers download their energy usage data or share it with apps through the NAESB ESPI standard. Learn how both modes and versions work."
canonical: "https://quantlix.com/en/standards/green-button/"
last-updated: 2026-11-16
---

Source: https://quantlix.com/en/standards/green-button/
Language: en
Description: Green Button lets utility customers download their energy usage data or share it with apps through the NAESB ESPI standard. Learn how both modes and versions work.

**Green Button** [Energy and grid systems](https://quantlix.com/en/standards/#grid)

# Green Button: standard energy usage data for customers and apps

Green Button is the North American initiative, built on the NAESB REQ.21 ESPI standard, that lets utility customers download their energy usage data or authorize apps to receive it directly.

[Discuss your project](https://quantlix.com/en/contact/) [Read the key points](https://quantlix.com/en/standards/green-button/#standard-overview)

## At a glance

**Full name**

Green Button, based on the NAESB REQ.21 Energy Services Provider Interface (ESPI) Model Business Practices

**Published by**

North American Energy Standards Board (NAESB) for ESPI; Green Button Alliance for testing and certification

**Type**

Data exchange standard and industry initiative

**Current version**

REQ.21 ESPI in NAESB Retail Version 4.1, published 15 May 2026; Version 4.0 dated 13 December 2023

**Applies to**

Electric, gas and water utilities and the authorized third parties that receive customer usage data, mainly in the United States and Canada

**Last reviewed**

November 16, 2026 (2026-11-16)

## In plain terms

### Key points

- Download My Data gives customers a standard XML file; Connect My Data sends data to an app the customer authorizes.
- NAESB publishes the ESPI model business practices, and the Green Button Alliance runs testing and certification.
- Version 4.1, published in May 2026, is current and removed SFTP as a transport option.
- Connect My Data uses OAuth 2.0 authorization, which the customer can revoke at any time.
- ESPI schema files carry their own version attribute, so record the schema version each partner declares.

### What is Green Button?

Green Button is **a standard way for utility customers to get their energy usage data and share it**, built on the Energy Services Provider Interface (ESPI) from the North American Energy Standards Board (NAESB). The name comes from the button a customer clicks on a utility website to download their data.

It began in September 2011, when the U.S. Chief Technology Officer challenged utilities to give customers easy online access to their own usage data, and the first utilities launched it in January 2012. NAESB released the ESPI standard in the fall of 2011. The Green Button Alliance, a nonprofit formed with support from NIST, the Department of Energy and industry partners, now promotes the standard and runs its testing.

### What Green Button covers

- **Download My Data.** A customer downloads their electricity, gas or water usage from the utility website as a standard XML file.
- **Connect My Data.** A customer authorizes an app or service provider to receive their data directly from the utility, for an agreed period and with the right to revoke.
- **A common data model.** ESPI defines XML resources, delivered as Atom feeds, for usage points, meter readings, interval blocks, usage summaries and retail customer information.
- **Authorization.** Connect My Data uses OAuth 2.0, which replaced OAuth 1.0 in ESPI Version 3.3, so apps receive scoped access tokens instead of customer passwords.
- **Testing and certification.** The Green Button Alliance runs testing programs for both modes, and only implementations that pass can claim certification.

### Versions and the schema caveat

**ESPI lives inside NAESB’s retail model business practices as REQ.21**, so it changes with each retail version. Version 3.3 of January 2020 moved Connect My Data to OAuth 2.0, set TLS 1.2 as the minimum and added a retail customer schema. Version 4.0 of 13 December 2023 brought cybersecurity updates and a way for authorized apps to retrieve copies of billing statements. Version 4.1, published on 15 May 2026, removed SFTP as a transport option.

Schema files need extra care. The version attribute inside an ESPI schema file is what identifies it, and copies published in different places have not always matched the folder or label they sit under. Record the schema version, a checksum of the file you validate against and the version your partner says it supports.

### How it shows up in software projects

- **Consent records.** Each Connect My Data authorization is stored with its scope, duration and revocation status, and data stops flowing as soon as a customer withdraws.
- **Token handling.** Access and refresh tokens stay on the server, are rotated and never appear in browsers or logs.
- **Interval data at volume.** Interval readings arrive in large feeds, so ingestion handles time zones, daylight saving changes, estimated readings and corrections.
- **Privacy by design.** Customer and usage data is personal information, so access control, retention limits and audit trails are part of the design from the start.
- **Validation.** Files are checked against the ESPI schema version the partner declares before they reach analytics or billing.

### How we work with Green Button

We build Green Button data flows on both sides of the connection: utility portals and APIs that publish usage data, and third-party apps that request customer consent and turn interval data into useful insight through [data analytics](https://quantlix.com/en/services/data-analytics/). The same data supports building energy and emissions work in [climate and sustainability](https://quantlix.com/en/industries/climate-and-sustainability/).

Certification is granted by the Green Button Alliance after its testing, and privacy obligations come from your regulator and the laws that apply to you. We design to make those reviews straightforward. Green Button projects run through our Utilities and Infrastructure practice, led by [Dr. Abdel-Hadi Hor](https://quantlix.com/en/about/leadership/abdel-hadi-hor/); see [energy and utilities](https://quantlix.com/en/industries/energy-and-utilities/) and our [OpenADR](https://quantlix.com/en/standards/openadr/) guide for another customer-side standard.

## Where it applies

Industries where this standard often shapes the work.

- ### [Energy & Utilities](https://quantlix.com/en/industries/energy-and-utilities/)

  Renewable energy, smart grids and energy storage systems

## Related standards

[All standards](https://quantlix.com/en/standards/)

- OpenADR

  ### [Automated demand response signals](https://quantlix.com/en/standards/openadr/)

  OpenADR is the Open Automated Demand Response standard from the OpenADR Alliance, used by utilities and aggregators to send demand response, price and grid signals to customer systems and receive reports back.
- IEEE 2030.5

  ### [Smart Energy Profile for DER](https://quantlix.com/en/standards/ieee-2030-5/)

  IEEE 2030.5 is the IEEE application protocol, also known as Smart Energy Profile 2.0, that lets utilities exchange schedules, controls and data with inverters, storage, EV chargers and other energy devices over IP networks.
- IEC 61968-11

  ### [CIM extensions for distribution](https://quantlix.com/en/standards/iec-61968-11/)

  IEC 61968-11 is the international standard that extends the Common Information Model (CIM) to electricity distribution, so GIS, asset, outage and metering systems can describe the same network in the same way.

## Services that support this work

The services we usually bring to projects that involve this standard.

[View all services](https://quantlix.com/en/services/)

### [Web application development](https://quantlix.com/en/services/web-application-development/)

Quantlix designs and builds web applications with responsive interfaces, business logic and system integrations, balancing accessibility, performance and maintainability.

### [Data analytics](https://quantlix.com/en/services/data-analytics/)

Quantlix builds analytics pipelines and business intelligence tools that turn operational data into defined metrics, useful reports and decision support.

### [Enterprise applications](https://quantlix.com/en/services/enterprise-applications/)

Quantlix designs and builds enterprise applications for internal workflows, business rules and system integration, with clear access controls and maintainable architecture.

## Questions, answered

What teams usually ask us about this standard.

**What is the difference between Download My Data and Connect My Data?**

Download My Data lets customers save their own usage file from the utility website. Connect My Data lets a customer authorize a third-party app to receive data directly for an agreed period, and the customer can revoke that permission at any time.

**What is the latest version of the ESPI standard?**

NAESB published REQ.21 ESPI as part of Retail Version 4.1 on 15 May 2026, which removed SFTP as a transport option. Version 4.0 of 13 December 2023 added cybersecurity updates and retrieval of billing statements by authorized apps.

**Is Green Button mandatory for utilities?**

Not nationally. Green Button began as a voluntary, industry-led response to a White House call to action in 2011. Where requirements exist, they come from state or provincial regulators, so check the rules that apply to your utility.

**Which data does Green Button cover?**

Electricity, natural gas and water usage at intervals such as 15 minutes, hourly, daily or monthly, depending on what the utility offers. The standard also covers related information such as demand, pricing and billing.

**How do you get Green Button certified?**

The Green Button Alliance runs testing programs for Download My Data and Connect My Data. Certification is optional and has a fee, applicants need the latest published standard, and the free validator only pre-checks files against the schema.

## Official sources

Read the official text before relying on any detail. What applies to you depends on your role, your location and the version in force.

- [NAESB retail model business practices, including REQ.21 ESPI](https://www.naesb.org/retail_standards.asp)
- [Green Button standard (Green Button Alliance)](https://www.greenbuttonalliance.org/green-button)
- [Green Button (U.S. Department of Energy)](https://www.energy.gov/data/green-button)
- [NAESB retail final actions for ESPI](https://www.naesb.org/req/req_final.asp)

These guides explain each standard in plain terms. They are not legal advice, and they do not state that any product or organization conforms to a standard.

## Planning software around this standard?

Tell us which systems are involved and what you need to show. We will help you build the requirements in from the start.

[Discuss your project](https://quantlix.com/en/contact/)
