There are several ways to access customer-authorized data via API. Our latest APIs follow the current North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI) standard and provide access to Energy Usage Information (EUI) through a set of RESTful interfaces.
But first, you must register to use the Share My Data platform before customers can authorize you to access their data. Follow the steps below to gain access.
Before you begin the registration process, be sure you have the following information on hand.
The Share My Data registration process allows you to identify yourself to PG&E as a company—or other entity—that would like to access customer-authorized data and set up access to our APIs. There are four distinct user types for Share My Data. Select the appropriate user type for your requested access.
Once you have gathered all of the required elements, register on the Share My Data API Portal.
Data requests and responses are made using the HTTPS protocol and are authenticated via a two-way certificate exchange with PG&E. You will need to implement security certificates for secure inbound and outbound API communications.
You will also need to maintain unexpired, unrevoked RSA certificates with a public key length of at least 2048 bits. The SSL Certificate is a prerequisite to completing the testing, so please make sure that your certificate is ready and available. PG&E currently supports only SHA-2 X.509 certificates issued by reputable certificate authorities (PG&E does not accept self-signed certificates), including AddTrust, Comodo, DigiCert. Entrust, GlobalSign, Go Daddy,USERTrust and VeriSign.
As a user of Share My Data, you are required to agree to PG&E's Share My Data Terms and Conditions, as well as acknowledge the California Public Utilities Commission's privacy rules.
Upon submitting your online registration form, we will send an email to the business contact email address provided. This is to confirm that we have your correct contact information. Please select the link contained in this email within five days of receipt. If you don't, you will need to resubmit the online registration form. Once you have confirmed your email address, we will process your registration.
The purpose of testing is to verify that you are able to connect to our systems. Once we have reviewed your registration information, we will send an email informing you that you can begin testing. There are three components to the overall testing process:
PLEASE NOTE: You must complete testing within 90 days of receiving the notification.
Once testing is complete, you will receive a confirmation email that testing has been successfully completed. After a final review, the status of your registration will be moved to Approved. At this point, you can access data and, if your user type authorizes you to access a customer's data, the customer will be able to provide you with authorization. Additionally, customers authorizing the release of their data will be able to see that your organization has access. If you wish to disable customer visibility, you may do so from within the third-party portal.
To learn about the authorization process, please visit the Customer Authorization Overview page.