Share My Data

Access and share your energy usage data

About Share My Data

PG&E developed Share My Data in response to a challenge by the White House to utility companies to provide customers with their energy usage information in an easy-to-use format.

 

This initiative makes your detailed energy usage information available in a standardized file format, and is intended to empower customers by raising awareness of energy usage and encourage companies to develop new, innovative customer-focused applications.

Share My Data can help lower energy costs

Reduce your energy costs

Third-party companies offer analysis and tools to help you save money. They can help you understand both your energy usage and what it costs to use appliances, electric vehicles, solar panels and other products.

Getting started is easy

Go to the website of the company with which you are planning to share your energy data. Or, sign in to your PG&E online account to authorize access to your data.

It's simple and secure

You'll need to set up authorization only once. Share My Data will package up PG&E data, inform the third-party company when it's ready and then securely transfer the data to them. You may cancel your authorization instantly, at any time, by logging into your PG&E online account, and selecting the Share My Data link to manage your existing data authorizations.

Third-party companies seeking customer data

The Share My Data platform delivers electric meter interval and gas meter data about energy usage, as well as billing information. Delivery is through a secure API connection to self-service or third-party software connections.

 

To get third-party access to customer data, securely and automatically, register with Share My Data Third Party Portal.

New to Share My Data and need to learn more?

Get customer-approved access to interval data for both electricity and gas usage.

Familiar with Share My Data but could use help?

Get consistent, reliable customer-approved energy data access through APIs. No need to “screen scrape” or download CSV files.

Experienced developer who wants more technical information?

Get access to detailed information about the Share My Data service and sample codes.

Allow third-party access

Share My Data enables you to share your energy usage with approved third-party companies.

 

There are two ways to share your usage data with a company:

  • You can share your data when you register with a third-party company on their website
  • You can select your third party from the drop-down list of approved Share My Data Service Providers

 

Sharing data via a third-party company app:

Some companies have integrated the authorization process into their websites, registration and other online processes. Oftentimes, these companies will provide a link so you can share your PG&E data with them directly. You will be redirected to your PG&E online account, and once you’ve completed the required steps within your account, you’ll automatically be redirected back to the company’s website.

 

Sharing data through your online PG&E account:

Resources for business customers:

View the usage data downloading options for customers or authorized third parties. Find the data-sharing tools and programs available to you, based on account type.

Access your own data

To access information about your energy usage via Share My Data’s API’s, you need to go through a registration process. This process includes connectivity testing to our Application Programming Interfaces (APIs), and select your service IDs. At this point you'll be able to utilize the Share My Data APIs to access your usage information.

 

Get started

The first steps for PG&E customers wishing to access their own information through Share My Data are nearly identical to those for third-party companies. PG&E has put together a comprehensive Get Started guide you can follow to gain access. Once you’ve completed the steps within the guide, come back here and continue with the final two steps listed below.

 

Select the Service Agreements IDs you want to access

Once you complete registration and successfully pass connectivity testing, select which Service IDs you want to access by logging in to your PG&E online account. Use the same PG&E ID provided during registration, and select the "Share My Data" link.

  1. This will take you to the Share My Data welcome page. On this page, select "I want to create a new authorization."
  2. A drop-down list of available companies will appear under your username. Select your PG&E username from the drop-down menu and select “next.” Then select the Service IDs and the date range you want to access. Once you submit the authorization, you'll be able to access your data.

 

Authorize self-access to your data

As a registered self-access user of Share My Data, you are assigned a unique Client Access Token, retrieved as part of connectivity testing. Using the Client Access Token, you can retrieve the Authorization resource, which will provide a bulk resource URL and unique Bulk ID assigned to you (e.g., https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}) to be used for retrieving usage data for all authorized self-selected service IDs.

 

After selecting your service IDs and authorizing self-access, you can request your usage data by using the Client Access Token to make a request for usage data against the bulk request url.


Get more information about Share My Data: Data Access

Frequently asked questions

About Share My Data

Technical support

About third-party companies

About privacy and security

Find data-sharing tools

Tools are available to customers and third parties, based on account type. Use them to access your own usage data or to share it. Find tools and programs to best fit your needs in the Energy Data Hub.

More resources

Need help?

We provide free support for your needs. Email our team: sharemydata@pge.com.

Third parties receiving data must be PG&E-approved

If the company you’ve selected has not yet registered with PG&E, ask them to contact sharemydata@pge.com.