Share My Data

• Any qualifying third party interested in accessing customer-authorized data can use Share My Data.
• Customers with the technical knowledge to use RESTful APIs (Application Program Interface) to access their own data can use the tool as well.
• If you are a Third-party Demand Response Provider (DRP) participating under PG&E’s Rule 24 program to offer a demand response program and would like to use Share My Data, please visit the DRP webpage for more information.

• Any qualifying third party interested in accessing customer-authorized data can use Share My Data.
• Customers with the technical knowledge to use RESTful APIs (Application Program Interface) to access their own data can use the tool as well.
• If you are a Third-party Demand Response Provider (DRP) participating under PG&E’s Rule 24 program to offer a demand response program and would like to use Share My Data, please visit the DRP webpage for more information.

• Making detailed energy usage information available in a standardized format encourages awareness of energy use as well as innovation among third parties for new customer-focused applications. The hope is that energy app developers will imagine and create innovative, inspiring new ways for customers to relate to, manage and ultimately reduce their energy usage. This solution 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. Share My Data provides the data following the Energy Service Provider Interface (ESPI) standard.
• 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.

• Energy conservation helps makes the energy grid in California more reliable.
• Conserving also helps our customers since using less energy can save them money.
• PG&E does not make higher profits by selling more energy, which makes PG&E and other investor-owned utilities in California distinctly different from 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 about PG&E's electricity rates

• There is no cost to use Share My Data.

• Through the Green Button Download My Data tool, customers can download their personal usage data and, if they elect, send the file to any third party they choose.
• This tool will remain available.

• Customers must authorize the release of their data to a third party using Share My Data or download their data via Green Button Download My Data file to their own computers and then send the file to third-party service providers.

• Yes. Visit the webpage, below, to view a list of other utilities that are implementing similar programs.

Visit greenbuttondata.org

• For this tool, the CPUC is the ultimate governing authority on who is not eligible to receive authorized customer data. 
• The CPUC reviews reports of misuse of customer data and makes final determinations as to whether terms of the Tariff and/or Customer Data Privacy and Protection Rules have been violated.
• The Commission has the authority to order utilities to immediately revoke access and terminate registration of companies or individuals that are in violation and bar them from future participation. For more information, select the links below:
  Download Advice Letter 4378-E-A (PDF, 198 KB)
  Download Electric Rule No. 27 (PDF, 1.6 MB)

• For more information on the ESPI standard, visit greenbuttondata.org

Please review and gather the following information before registration with Share My Data.

• We operate and maintain the Share My Data platform to facilitate the registration of companies who wish to participate in the Share My Data program.
• We screen applicants to verify that they are legitimate business entities in good standing with the CPUC, that they agree to abide by the terms and conditions and the Customer Data Access Tariff and that they have the technical capability to use the Share My Data platform.
• We strongly recommend that customers investigate how the companies that they choose to do business with will manage and protect their data.

• PG&E will support one company name and Tax ID for various registrations. This means a single company can have several registrations with different display names.
• You will need to establish the understanding with your customers to authorize the company name and/or display name you provide in your various registration.

• Your Federal Tax ID is required to provide the California Investor Owned Utilities (Pacific Gas and Electric, Southern California Edison and San Diego Gas & Electric) and the California Public Utilities Commission (CPUC) with a common, unique identifier for you.

• Please go to the following webpage for detailed directions on how to complete the test.

Get more information about testing details

• Once you receive an email indicating your registration has been accepted, you will be able to log in to your Share My Data account to retrieve your Client Credentials. Choose Manage Registration and your <Client_ID> and <Client_Secret> will be displayed in the Registration Milestone table under Accepted status.>

Log in to Share My Data

• Once you receive an email indicating your registration has been accepted, you have 90 days to complete registration testing.
• If you are unable to complete registration testing within 90 days, your registration will expire and you will need to reregister.

Yes, the registration will expire. Once your registration is accepted for testing, you must complete testing and confirm your organization's ability to connect to PG&E's systems within the 90 days. If you have successfully completed the testing requirements and become an approved third party on the Share My Data platform, your registration will not expire.

• We are not able to reset passwords if you do not know the answer to your security question.

• Please contact us at ShareMyData@pge.com for more information regarding company name changes.
• Under most circumstances, we will not be able to change your company name on your existing registration. You will need to contact us to terminate your existing registration and reregister with your new company name. Customers will then have to reauthorize you to access their data under your new company name.

• You can log in to your account at any time to update your profile information by selecting Manage Registration.

Log in to Share My Data

• Once you receive an email indicating your registration has been accepted, you will be able to log in to your account to retrieve your <Registration_Access_Token>. Select "Manage Registration" and your <Registration_Access_Token> will be displayed in the Registration Milestone table under Accepted status.

• If you no longer wish to access customer-authorized data on the Share My Data platform, please email us at ShareMyData@pge.com to have your registration terminated. Please allow up to two business days for termination to be completed.

• Customers authorize you to access their data via My Energy, their PG&E online account. For a detailed overview of how customers can authorize third parties or other entities to access their data, please view the Share My Data Third-Party Overview.

Go to Authorization Details

• Currently, there is no limit.

• Customers can either choose a specified amount of time for which you can access their data, or they can leave the authorization period open.
• Your application can check the end date of a customer authorization along with other authorization details by calling the authorization resource APIs (e.g., .../espi/1_1/resource/Authorization and/or.../espi/1_1/resource/Authorization/{AuthorizationID}).
• Alternatively, you can manually check authorization end dates by logging in to your account and selecting Manage Authorizations.

• If a customer chooses a defined period of authorization, then their authorization expires at the end of that time period. If they cancel the authorization, then their authorization expires the day after they cancel the authorization.
• If a customer chooses Indefinite as their authorization period, then their authorization does not expire. Note, in consideration of Rule 24 Demand Response Providers and other programs using Share My Data, after-the-fact corrections for previously authorized date ranges may be provided to third parties for up to three years after authorization expiration.
• See "How will data corrections be handled?" for further details on receiving corrections.

• Any PG&E customer with a currently active Service ID for gas or electric service can authorize you to access their data using the new Share My Data tool.

• Customers interested in participating in sharing their data via the Share My Data program are highly encouraged to register for a My Energy account. This will make the entire process more efficient and also gives them the capability to manage their authorizations online.
• Customers can sign up for a My Energy account during the authorization process.
• There is a manual process available to customers to obtain a Share My Data Authorization Form online and submit the completed form via email.
• For more information about the manual process, please contact us at ShareMyData@pge.com.

• Customers are required to make their own authorizations online through their PG&E online account. However, if they complete and sign the Share My Data Authorization form, then you may submit it to PG&E on their behalf.

Download Share My Data Customer Authorization or Revocation of Authorization Form (PDF, 308 KB)

• You can update your OAuth URIs by logging into your account, navigating to Manage Registration > Edit > and updating the fields under the OAuth 2.0 Information section.

• You can update your Notification URI by logging into your account, navigating to Manage Registration > Edit > and updating the fields under the Data Access Information section.

• You can update your SSL certificate by logging into your account, navigating to Manage Registration > Edit > and selecting "Update" in the SSL Certificate Information section. Note that for new certificate uploads, it may take several days to update PG&E systems with the new certificate.  
• A confirmation email from the Share My Data Support team will be sent when the new certificate has been applied.

• Once you receive an email indicating your registration has been accepted, you will be able to log in to your Share My Data account and download our SSL Certificate via the Download PG&E SSL Certificate page.

Log in to Share My Data

• Share My Data follows the Green Button Connect My Data implementation agreements. Share My Data also employs OAuth 2.0 for authorization, Transport Layer Security (TLS) 1.2 and the minimum suite of cyber security protocols approved by NIST (National Institute of Standards and Technology) such that no information is exchanged in the clear.

• Protecting customer information is a top priority for PG&E. PG&E treats information about their customers—including personal information—as confidential, consistent with all legal and regulatory requirements, including those established by the California Public Utilities Commission and others.  
• For more than two decades, PG&E and other investor-owned utilities in California have been subject to very strict CPUC regulations that prohibit them from disclosing customer-specific information, such as billing data, to third parties without the express consent of the customer.  
• Once a customer authorizes the release of data, it is the customer’s and third party’s responsibility to protect that data.
• A customer can elect to stop sharing data with a third party at any time by logging in to their PG&E online account and cancelling their authorization. PG&E’s complete privacy policy and Notice of Accessing, Collecting, Storing, Using and Disclosing Energy Usage Information is available at pge.com/privacy.

• Within the scope of the Share My Data program, Third parties are subject to the Customer Data Privacy and Protection Rules specified in the Share My Data platform terms and conditions and to the requirements included in the Customer Data Access Tariff.
• Third parties are also subject to all other applicable laws and regulations relating to the protection of customer privacy, including, but not limited to, the Rules Regarding Privacy and Security Protections for Energy Usage Data adopted by the CPUC as Attachment D to Decision 11-07-056 (Electric), also summarized in PG&E’s Electric Rule No. 27, and California Civil Code Section 1798.80 – 1798.84.
• For more information, please select the links, below:
  Download Share My Data Terms and Conditions (PDF, 108 KB)
  Download Electric Rule No. 27 (PDF, 1.6 MB)
  Download Attachment D to Decision 11-07-056 (PDF, 380 KB
  Find more information: California Civil Code Section 1798.80 – 1798.84

• Please refer to the link, below, for a detailed list of the data elements that are supported.

Get more information about data access

• On occasion, interval usage data is missing because our upstream data validation processes find there are missing or incorrect data reads that may require further processing (editing and or estimation).
• For interval billed customers (e.g., customers with Time-of-Use billing considerations), these instances are corrected in time to ensure accurate bill calculation on their upcoming monthly bill.

• If you would like to receive data corrections, please ensure that you check the Notify Me as Data is Ready checkbox during registration or by logging in to your online account and selecting this checkbox under Edit Profile. We will then include data corrections that have been captured by our system during the previous 24 hours, as part of the daily usage feed, for any data you are authorized to access.
• Data corrections will cover any changes for the authorized period, up to a maximum of three years.

PLEASE NOTE: In consideration of Rule 24 Demand Response Providers and other programs using Share My Data, after-the-fact corrections for previously authorized date ranges may be provided to 3rd parties for up to three years after authorization expiration.

• If applicable, PG&E will send notifications to your notification URL provided during registration. Notifications comprise URLs corresponding to already pre-packaged data ready for you to come back and request at the provided URLs. Data is prepackaged and notifications sent out in the following two scenarios: (1) you've selected "Notify me as data is ready" in your registration profile, in which case we'll package the latest daily data with any corrections for past dates, or (2) you've made an earlier ad hoc asynchronous request for which the requested data is now ready. Scenario 1 is illustrated under the "DATA ACCESS: DAILY SUBSCRIPTION" section of the Data Access Methods diagrams on the Data Access Page and scenario 2 is illustrated under the "DATA ACCESS: AD HOC REQUEST (ASYNCHRONOUS)" section of the same diagrams also on the Data Access Page.

Visit the Data Access page

• For an explanation of how PG&E defines and indicates Revenue Quality data for electric meters within the Share My Data platform, please reference the Sample Explanation in Attachment 2 of Advice Letter 4378-E-A.
  Download Advice Letter 4378-E-A (PDF, 236 KB)
• The electric usage data provided by Share My Data is not Settlement Quality Meter Data (SQMD) as specified by the California Independent System Operator (CAISO). SQMD is generated by multiplying Revenue Quality Meter Data (RQMD) by the Distribution Loss Factor (DLF) applicable to that customer's voltage level for that interval, converting the metered intervals to the interval period required by the CAISO and then summing the results for each interval to the aggregate level required by the CAISO.
• PG&E is implementing flags of the "QualityOfReading" (QOR) Type provided by the ESPI standard to communicate whether data is Revenue Quality. The QOR Type captures different possible quality values for usage data, including an explicit value for “Revenue Quality Meter Data” or "RQMD." PG&E will use this QOR Type in its data transmittal as follows:
  • PG&E supports the ESPI provided "UsageSummary" class, which will be used to identify the dates for which a service agreement is billed, the billed usage amount, and the usage data quality at the time of request. The UsageSummary will be populated once the bill is available for the requested data and will include two flags (elements) of QOR Type:
    • The UsageSummary.QualityOfReading element (at the UsageSummary level) indicating the quality at the time of request of latest provided interval usage values plus corrections corresponding to the UsageSummary.billingPeriod dates.
    • The DefaultQuality element for OverallConsumptionLastPeriod (as part of UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) indicating the quality of the total billed usage.
  • PG&E will also communicate the quality of usage data at the interval level at the time of request using the IntervalReading.ReadingQuality.Quality element.

• During registration you can select how much historical data you need, either 24, 36, or 48 months under the "How much historical data is requested" dropdown.
• As part of a customer's authorization allowing you to access their data, the historical period for authorization will be defaulted to your registration selection for the Service IDs (usage points) included in the authorization.
• You can update your requested historical data, by logging into to your account, navigating to Manage Registration > Edit > and selecting from the dropdown labeled "How much historical data is requested."
• Please note that the data provided in the historical request will begin with the date that the customer makes the authorization, as opposed to the date that you make the request to the API.

PLEASE NOTE: Changes to your requested historical data only affect new customer authorizations, while previous customer authorizations will reflect your selection at the time of authorization.

• As per the ESPI standard, the response uses the Atom Publishing Standard. Please select the link, below, to see a complete list of APIs that are supported, along with available data elements.

Get more information about data access

• Active electric and gas Service IDs installed and read by PG&E are eligible for authorization via the Share My Data platform.
• If the Service ID associated with an authorization changes due to one of the following reasons, the authorization will transition to the new Service ID and access to historical interval usage data will continue:
  • Temporary shut off due to non-payments
  • Move to Interval Billing
  • Exchange of meter
  • Rate change
• Other scenarios that result in a change in Service ID such as moving locations or the change of a company will terminate access. In addition, if an account is unlinked from your My Energy account, all underlying Service IDs that were authorized via Share My Data will be unauthorized as a result.

• To determine the granularity of authorized interval data, please reference the Interval Length element as provided by the ESPI standard.
• PG&E is providing interval usage data at the same granularity as collected for billing purposes, which is generally on an hourly or 15-minute basis for electric data and daily for gas data for those customers with interval meters. Whereas it can vary by customer, electric interval meter usage is generally available at the hourly level for most residential customers and at the 15-minute interval level for most commercial customers, and gas interval meter usage is generally available at the daily level for most customers.
• For non-interval meters, data will be provided when available.

• For the large majority of PG&E customers with a Smart Meter installed, electric and gas interval usage data is available by the end of the next day via the Share My Data platform.
• The small portion of PG&E electric customers with power line carrier based MV90 meters installed may require additional time for data to be available.

• While we cannot directly support setup of your APIs, we do have a number of resources available to assist your IT and technical resources in the development process. Please reference our API Documentation page to learn more. Please also feel free to contact ShareMyData@pge.com with any additional questions.

For more information visit Application Programming Interface (API)