# PG&E Share My Data (Green Button Connect My Data) ESPI API **Canonical:** https://apis.io/apis/pge/pge-share-my-data-espi-api/ **Provider:** Pacific Gas and Electric — https://apis.io/providers/pge/ **Base URL:** https://api.pge.com/GreenButtonConnect/espi/1_1/resource **Documentation:** https://www.pge.com/en/save-energy-and-money/energy-saving-programs/smartmeter/third-party-companies.html PG&E Share My Data (Green Button Connect My Data) ESPI API is one of 2 APIs that [Pacific Gas and Electric](https://apis.io/providers/pge/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Green Button, ESPI, Energy Data, Smart Metering, and Electricity. The published artifact set on APIs.io includes API documentation, an API reference, an OpenAPI specification, rate-limit docs, sample payloads, and SDKs. PG&E's production Green Button Connect My Data implementation, branded Share My Data. A NAESB REQ.21 Energy Services Provider Interface (ESPI) 1.1 REST API returning Green Button Atom/XML, serving customer-authorized electric and gas interval usage, usage summaries, reading types, billing and account information, service tariff and rate-plan detail, and demand response program enrollment. PG&E's own Supported-APIs reference enumerates the resource set: DownloadSampleData, ReadServiceStatus, ApplicationInformation, Authorization (feed, single, and DELETE revocation), LocalTimeParameters, ReadingType, Subscription UsagePoint / MeterReading / IntervalBlock / UsageSummary trees, and the asynchronous Batch family — Batch/Bulk/{BulkID}, Batch/Subscription/{SubscriptionID}, Batch/BulkRetailCustomerInfo/{BulkID}, Batch/RetailCustomer/{RetailCustomerID}, Batch/BulkRetailDRPrgInfo/{BulkID} and Batch/RetailDRPrgInfo/{RetailCustomerID}. Asynchronous results are announced to a third party's registered notification URI. Every production request runs over mutual (two-way) TLS 1.2 with the third party's X.509 client certificate attached, plus a bearer token — client_access_token for third-party-level resources, per-customer access_token for subscription resources, registration_access_token for ApplicationInformation. Verified live anonymously on 2026-07-27: the ESPI resource paths answer HTTP 400 "Invalid Certificate" from a Mulesoft-API-Gateway while invented sibling paths answer HTTP 404 "No listener for endpoint", which distinguishes a real mTLS-protected listener from a catch-all. Access is application-approval gated; not self-serve. ## Machine-readable artifacts (30) - **Documentation** — https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html - **APIReference** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-APIs.pdf - **APIReference** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-APIs-Click-Thru-2.0.pdf - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Data-Elements.pdf - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Relational-Data-Model.pdf - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Process-Flow.pdf - **XSD** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-atom.xsd - **XSD** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-espiDerived-20180821.xsd - **XSD** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-retailcustomer-20180802.xsd - **XSD** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-click-thru-2.0-espiDerived-20180315.xsd - **XSD** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-click-thru-2.0-retailcustomer-20180315.xsd - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/openapi/green-button-alliance-espi-openapi.json - **Overlay** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/overlays/pge-green-button-alliance-espi-overlay.yaml - **Webhooks** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/asyncapi/pge-share-my-data-notifications.yml - **RateLimits** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/rate-limits/pge-rate-limits.yml - **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/errors/pge-problem-types.yml - **Conventions** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/conventions/pge-conventions.yml - **DataModel** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/data-model/pge-data-model.yml - **Sandbox** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/sandbox/pge-sandbox.yml - **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/skills/_index.yml - **Example** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/MeterReadings_Example.zip - **SDK** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/pythonsdk.zip - **SDK** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/javascriptsdk.zip - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/smd-python-development-guide.pdf - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/smd-javascript-development-guide.pdf - **Documentation** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/soap-ui-steps.pdf - **TermsOfService** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/ShareMyData_Platform_TermsofUse.pdf - **Registration** — https://sharemydata.pge.com/ - **Reference** — https://www.pge.com/tariffs/assets/pdf/tariffbook/ELEC_FORMS_79-1186.pdf - **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/apis.yml ## Other Pacific Gas and Electric APIs (1) - [PG&E Share My Data OAuth 2.0 Authorization API](https://apis.io/apis/pge/pge-share-my-data-oauth-api/) ## Tags Green Button, ESPI, Energy Data, Smart Metering, Electricity, Gas, Demand Response --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pge/pge-share-my-data-espi-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pge/.