The following prerequisites must be met before you can access our APIs:
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
The Supported APIs document shows the APIs supported by PG&E's implementation of Share My Data, as well as the PG&E specific API URL.
The Supported Function Block Scope String Mapping document captures details on the scope string that is returned as part of responses to the Authorization Code Request, the Access Token Request, as well as the Authorization API as described in the Authorization Details Overview. The Scope parameter allows for communicating the final scope of customer authorization. In addition, this document lists which ESPI standard function blocks PG&E's Share My Data implementation supports.
In conjunction with the Supported Data Elements document, the Supported Relational Data Model illustrates how the relationship between the different PG&E data elements is captured by the ESPI standard.
The Supported Data Elements document provides a mapping between the ESPI standard data elements and PG&E's data elements.
PG&E's implementation is compatible with the ESPI provided schema definitions found on GitHub. Specifically, our current implementation uses the following schema versions:
Please reference the following sources on how to complete the signature for each API request and to test the API call against GBC's API Sandbox:
During registration, you will need to provide a Notification URI so that our systems can notify you of any changes to your authorizations (e.g., customer cancellations), in the case of asynchronous data requests (for larger data sets only), and when your requested data is ready. Separately, if you would like to receive daily subscription notifications of the most recently available data plus any corrections for previous data from the last 24 hours, select the Notify me as data is ready checkbox in your registration. We will prepackage the latest day's data and notify you at your Notification URI to come back and retrieve the data.
PLEASE NOTE: If you do not intend to retrieve data on daily basis, we ask you not to check the Notify me as data is ready option so as to reduce the amount of unnecessary data we process. You will still be able to make ad hoc requests for data.