Green Button

Responding to the challenge issued by the White House in Fall 2011, PG&E launched "Green Button" for its customers enabling a simple download of personalized energy usage data through its secure website, My Energy. Using Green Button:

What is Green Button Download My Data?

Customers can access the last 13 months of their electric usage data through Green Button Download My Data.


How do I access Green Button Download My Data?

Customers need to have a My Energy account and an electric SmartMeter™ connected to the network.

  • Click on the My Usage tab.

  • Click on the Green Button icon and select your download format.

  • Download the file and use the file yourself or send it to a third-party service provider.

What is Green Button Connect My Data (Beta)

Green Button Connect My Data (Beta) gives customers greater control over your SmartMeter™ electric usage data. Green Button Connect My Data (Beta) is a software interface that allows PG&E customers to easily share their electric usage data with other companies and third-party service providers. These companies can then analyze your data in unique ways to help you save energy.


Introducing Green Button

Introducing Green Button Connect @ PG&E


What is Green Button Connect?


Beta means Green Button Connect My Data (Beta) is a trial project. PG&E has partnered with select third-party service providers that are offering unique ways to help our customers save energy, and we will continue to add more in the future. This trial will allow us to learn as much as we can about whether customers think this is a valuable service, and how we can make it even better.

Our current authorized third-party service providers include:

Third-party service providers can learn more about using Green Button Connect My Data (Beta) here: Green Button Connect API

How do I share my data through Green Button Connect My Data (Beta)?

Customers can choose to share their Green Button Connect data with third parties using a secure combination of Service ID and PIN code. Customers need to have a My Energy account and an electric SmartMeter™ connected to the network. Register

To get started, all you have to do is set up a PIN code for each of the electrical service agreements you wish to share. Then, provide this PIN / Service ID combination to the companies that you want to share your data with, and you're ready to go. If you wish to stop their access to your data at any time, simply change or delete your PIN.

How to Set Your Green Button Connect PIN


  • From the "Pay & Manage" tab, select "Accounts and Services".

  • Scroll down to find the table entitled "Services Linked to My Profile". Check the box(es) to activate Green Button Connect My Data (Beta) access to your eligible services*. Click "Add PIN" and enter a PIN code** for the selected service(s). Accept the terms and conditions to proceed.

  • You're almost done! Now share your electric usage data with one of PG&E's participating third-party service providers. To share your data, navigate to the third-party service provider's website and provide them with both your Service ID and PIN code.

* Currently, only active electric Service IDs are eligible for Green Button Connect My Data (Beta) API access.

FAQ

Why is PG&E doing this?

PG&E responded to the challenge from the White House to design a standard format for customers to access energy usage data online. PG&E launched what's called the Green Button on December 18, 2011, and is pleased to be among the first utilities in the country to empower customers with their own data in a portable format never before available. Making detailed energy usage information available in a standardized file format encourages awareness of energy use as well as innovation among third parties for new customer-focused applications.

Energy app developers will imagine and create innovative, inspiring new ways for customers to relate to, manage, and ultimately reduce their energy usage. Green Button Connect My Data (Beta) is the next step in a national effort to provide standardized, easy access to customer energy data that will unlock the next generation of conservation solutions. PG&E’s goal is to make authorized, recurring, machine-to-machine, programmatic data access available to customers and their authorized third-party service providers.

How does Green Button benefit customers?

Using Green Button products, customers can easily provide their energy usage data to third parties who are developing applications and tools to help consumers manage their energy use. Through the Green Button Download My Data, customers can download their personal data and send the file to any third party they choose. Through Green Button Connect My Data (Beta), customers can grant authorized third-party service providers access to their electric usage data, providing a seamless data sharing experience.

Is data accessed through Green Button products secure?

Yes. We have in place the latest password and security protections that prevent third-party service providers from accessing a customer's personal data. Customer can log into My Energy and download their own personal energy usage data through the Green Button Download My Data, then choose to send it to a third-party service provider.

Green Button Connect My Data (Beta) employs industry standard HTTPS protocol for data transfer, the same used by banks and online retailers. Authentication is handled in two stages: (1) third-party service providers must authenticate with PG&E in order to connect to the API; (2) third-party service providers must present both your Service ID and PIN code in order to access your data. PG&E has made every effort to ensure that our third-party service providers have proper data security protocols and technology in place to protect the data our customers share with them—however, customers should use their own discretion when deciding to share their energy usage data.

You can learn more about our commitment to customer privacy at www.pge.com/privacy.

Can third parties access this file directly from PG&E's website?

No. Customers must download the Green Button Download My Data file to their own computers and then send the file to third party service providers. As part of our commitment to maintaining customer privacy, PG&E does not deliver the file directly to third-party service providers.

How much data is in the file?

Customers can designate up to 13 months of data to be delivered in a single file. If the customer has not had a SmartMeter™ connected to the network for that long, then the customer can only download the amount of interval data since the transition.

Green Button Connect My Data (Beta) contains your Account Service ID and interval electric usage (in kilowatt hours).

Why does PG&E wants its customers to use less energy?

Energy conservation helps makes our energy grid more reliable in California and directly helps our customers save on their energy bill when they use less.

PG&E does not make higher profits by selling more energy, which makes PG&E and other investor-owned utilities in California distinctly different than most companies that make profits by selling more of a given commodity. One way PG&E makes money is through incentives earned by achieving energy efficiency goals set by our regulator, the California Public Utilities Commission.

When our customers conserve energy it's good for them and it's good for our business. Learn more at www.pge.com/rates/

How does Green Button Connect differ from Green Button?

Green Button Connect My Data (Beta) is something we’re trying out, designed to encourage innovation by making it easier for early adopters to share their past energy usage with third-party service providers. Unlike Green Button Download My Data (Beta), the Green Button Connect My Data (Beta) API is intended for software developers, not customers. However, by providing authorized, recurring, machine-to-machine, programmatic data access to customers’ electric usage data, our hope is to help customers unlock, in partnership with third-party service providers, new and creative ways to manage their energy usage.

With whom can I share my data through Green Button Connect My Data (Beta)?

By sharing your Service ID and PIN combination with authorized third-party service providers, customers can unlock their historic electric usage data.

Because Green Button Connect My Data (Beta) is still in beta, at this time PG&E is only authorizing a select number of third-party service providers to access the Green Button Connect My Data (Beta) API. Customers decide with which of these third-party service providers to share their data. Links to PG&E's eligible third-party service providers are listed below, and on the My Energy Accounts and Services page.

Our current authorized third parties include:

How does Green Button Connect My Data (Beta) work?

Customers can set up PIN code(s) for any of their eligible services. By sharing their PIN code and service ID with authorized third-party service providers, customers are granting access to their electric usage data. Once customers authorize third-party service providers to access their data, Green Button Connect My Data (Beta) will release data on a recurring basis with no additional action required on the part of customers. Customers can change or delete their PIN at any time to remove third-party service providers access to their data.

Who can use Green Button Connect My Data (Beta)?

Any customer with an electric SmartMeter™ may use Green Button Connect My Data (Beta).

What are the rules for setting up a PIN code?

PIN codes can be up to six numerical digits. Choose something hard for others to guess (e.g. NOT 123456). Customers can use the same PIN code for multiple eligible services.

What happens if I change or delete my PIN code?

If customers change or delete the PIN code, third-party service providers will no longer be able to access the data associated with that service. To grant access to your data, share your updated PIN and service ID with the third-party service provider. If customers no longer wish to share their PIN code with a third-party service prodiver, changing or deleting the PIN code will cut off their Green Button Connect My Data (Beta) access to your future data. Third-party service providers may still have previous historical data.

How long will Green Button Connect be available?

Green Button Connect My Data (Beta) will be available until Q4 2014. Beginning Q1 2015, Green Button Connect My Data (Beta) will be updated with a new third-party service provider registration process and customer data release authorization process. The new release will allow customers to share their data with a greater variety of third-party service providers. When the updated process is available, customers will need to reauthorize release of their data.

Log in to My Energy

Forgot your username or password?
Sign up for an account.

Privacy

We're committed to maintaining our customers' privacy. PG&E does not deliver energy usage data directly to third parties.

Read more about our Privacy Policy

Third-Party Service Providers and Developers

Additional information on using Green Button Connect My Data (Beta) is available here:

Green Button Connect API

Green Button Standards and Samples

Customers may provide their energy usage data to third-party service providers and developers via Green Button Download My Data (xml or csv file) or through Green Button Connect My Data (Beta) (ESPI standard file). Below we have provided a sample file for each of the downloadable formats.

XML Sample

CSV Sample

NAESB Standards

NIST Green Button Initiative

  • Energy Upgrade Califorinia