Registration


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 three parts to the process:

 

  1. Complete and submit the online registration form and provide your SSL Certificate
  2. Confirm your email address
  3. Complete testing

Complete and submit the online registration form

Select a User Type
Please Note: Should you have any questions as to the User Type that best fits your organization, please email sharemydata@pge.com prior to submitting your registration.

 

  • Standard User: Select if you wish to access customer data as a standard third party
  • Self-Access User: Select if you are an individual or represent an entity requesting access to your own data

Once you have selected your user type, the online registration form requires that you enter basic information about yourself or company, along with business and technical contact information. You'll also need to create credentials to log in to your account so that you can manage your registration profile and data access authorizations.

 

  • Energy Efficiency Finance: Select if your organization provides services related to: on-bill repayment, on-bill finance, or residential energy efficiency finance programs
  • Community Choice Aggregator: Select if you are a registered Community Choice Aggregator in PG&E's service territory. To see the list of currently registered CCA's, please visit Community Choice Aggregation


PLEASE NOTE:Only one set of credentials will be supported so if multiple individuals will be accessing your account online, you will need to share your username and password. If you forget your username, we will send it to the business contact email address you provide during registration. If you forget your password, you will need to answer your security question and we will send a password reset link to the business contact email address you provide during registration. We are unable to reset your password if you forget the answer to your security question.

Provide OAuth 2.0 URIs

The Share My Data Platform utilizes OAuth 2.0 protocol for authorization. If the User Type you have selected requires three-legged OAuth to access data, you will need to provide valid OAuth URIs before we can accept your registration.

The Share My Data Platform utilizes OAuth 2.0 protocol for authorization. If the User Type you have selected requires three-legged OAuth to access data, you will need to provide valid OAuth URIs before we can accept your registration.

FieldDefinition

OAuth URL

The OAuth URL you provide here will be used to direct customers to your customer login page to complete the authorization.
(referred to as in the ESPI ApplicationInformation Resource)

Third-Party Portal URI

This field is an information only URI and will not be used in the OAuth process. For example you can provide the URL for your Homepage or About Us page, and we may use it in the future to direct customers who want to know about your services. (referred to as in the ESPI ApplicationInformation Resource)

Redirect URI

The redirect URI you provide here is where PG&E will send the Authorization Code once customer authorization is completed and you make a request for the authorization code. (referred to as in the ESPI ApplicationInformation Resource)

Provide Data Access URI

You will need to provide a Notification URI in order for our systems to notify you when your requested data is ready. If you would like to receive data corrections, please check the Notify me as data is ready checkbox.

You will need to provide a Notification URI in order for our systems to notify you when your requested data is ready. If you would like to receive data corrections, please check the Notify me as data is ready checkbox.

FieldDefinition

Notification URI

The URI you provide here is where PG&E will send notifications that customer-authorized data is available (i.e., for asynchronous requests and daily subscription notification).
(referred to as in the ESPI ApplicationInformation Resource)

Notify me as data is ready flag

By checking this box, you are requesting customer-authorized data be published on a daily subscription basis. PG&E will notify you each day when the previous day's data, along with any corrections for the authorized period, is available.

Provide your SSL certificate

Data requests and responses are made using the secure HTTPS protocol and authenticated via a two-way certificate exchange with PG&E. Requesters will need to implement security certificates for secure inbound and outbound API communication.
As per the ESPI standard, you will 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 certificates issued by reputable certificate authorities, including the following:

 

  • AddTrust
  • Comodo
  • DigiCert
  • Entrust
  • GlobalSign
  • Go Daddy
  • USERTrust
  • VeriSign


Review and Submit
As a user of Share My Data, you will be 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.
Share My Data Terms and Condidtions (PDF)
Electric Rule No. 27 (PDF)

Confirm your email address

Upon submitting your online registration form, we will send an email to the business contact email address that you provided. This is to confirm that we have your correct contact information. Please select the link contained in this email within five days of receiving the email. 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.

Go to 3rd Party Registration Portal

Next step: Complete testing

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 you an email informing you that you can begin testing. There are three components to the overall testing process: API Connectivity Testing, OAuth Testing, and Application Information Resource Request. Continue to Testing Instructions

PLEASE NOTE:You must complete testing within 90 days of receiving the notification.

Upon completion of testing, you will receive a confirmation email and the status of your registration will automatically be moved to Approved. At this point you will be able to access data and, if your user type requires authorization to access data, customers will be able to authorize your access to their data. Additionally, it is at this point in registration that your organization will become visible to customers authorizing the release of their data. If you wish to disable customer visibility, you may do so from within the 3rd party portal.
To learn about the authorization process, please visit the Customer Authorization Overview page. Go to Authorization Overview