# Pacific Gas and Electric — Share My Data (Green Button Connect My Data) > Generated by API Evangelist on 2026-07-27 from all/pge/apis.yml and the artifacts in this repo. PG&E serves no /llms.txt of its own (HTTP 404 on www.pge.com, api.pge.com and sharemydata.pge.com, probed 2026-07-27), so this file is GENERATED, not harvested. Pacific Gas and Electric Company is the investor-owned electric and natural gas utility for northern and central California. Its API surface is Share My Data, a production NAESB REQ.21 ESPI 1.1 Green Button Connect My Data implementation running on a MuleSoft gateway at https://api.pge.com. The whole developer contract — endpoint reference, OAuth guide, XSD schemas, SDKs, rate limits, release notes — is published anonymously on pge.com without a login. The DATA is not open: access requires a US EIN, CPUC eligibility, a CA-issued X.509 client certificate, tariff acceptance, mandatory registration testing, PG&E approval, and then an individual customer's OAuth authorization. PG&E publishes no first-party OpenAPI; its machine-readable contract is XSD and its API reference is PDF. PG&E publishes no open market or grid API. ## APIs - [PG&E Share My Data (Green Button Connect My Data) ESPI API](https://www.pge.com/en/save-energy-and-money/energy-saving-programs/smartmeter/third-party-companies.html): ESPI 1.1 REST API returning Green Button Atom/XML — interval usage, usage summaries, reading types, billing, account, tariff/rate plan and demand response enrollment. Base URL https://api.pge.com/GreenButtonConnect/espi/1_1/resource. Mutual TLS 1.2 plus bearer token on every call. - [PG&E Share My Data OAuth 2.0 Authorization API](https://www.pge.com/en/save-energy-and-money/energy-saving-programs/smartmeter/third-party-companies.html): OAuth 2.0 authorization server implementing the NAESB ESPI authorization profile. Base URL https://api.pge.com/datacustodian/oauth/v2. Separate test server at https://api.pge.com/datacustodian/test/oauth/v2. Not OpenID Connect. ## Docs - [Third-party companies — the developer portal](https://www.pge.com/en/save-energy-and-money/energy-saving-programs/smartmeter/third-party-companies.html): registration prerequisites, OAuth flow with request/response examples, endpoint URLs, scope-string format, rate limits, notification model and dated release notes. - [Share My Data overview](https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html): programme overview, eligibility and third-party requirements. - [Supported APIs (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-APIs.pdf): the authoritative endpoint table — phase, category, sync/async, verb, query parameters, URL, required token class and ESPI function block. - [OAuth Authorization ESPI (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/OAuth_Authorization_ESPI.pdf): the NAESB ESPI OAuth 2.0 authorization guide. - [Supported Function Block Scope String Mapping (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Function-Block-Scope-String-Mapping-Click-Thru-2.0.pdf): PG&E's answer to a scope reference. - [Supported Data Elements (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Data-Elements.pdf) - [Supported Relational Data Model (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Relational-Data-Model.pdf) - [Process Flow (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Process-Flow.pdf) - [SoapUI walkthrough (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/soap-ui-steps.pdf) - [Share My Data Platform Terms of Use (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/ShareMyData_Platform_TermsofUse.pdf) - [Third-party registration and vendor sign-in](https://sharemydata.pge.com/) ## SDKs - [Python SDK (ZIP)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/pythonsdk.zip) with its [development guide (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/smd-python-development-guide.pdf) - [JavaScript SDK (ZIP)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/javascriptsdk.zip) with its [development guide (PDF)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/smd-javascript-development-guide.pdf) - Neither SDK is published to npm or PyPI; both are ZIP downloads from pge.com. github.com/pgetech has zero public repositories. ## Specs and schemas - [ESPI Atom schema](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-atom.xsd) - [espiDerived schema, 2018-08-21](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-espiDerived-20180821.xsd) - [retailcustomer schema, 2018-08-02](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-retailcustomer-20180802.xsd) - [Click-Thru 2.0 espiDerived schema, 2018-03-15](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-click-thru-2.0-espiDerived-20180315.xsd) - [Click-Thru 2.0 retailcustomer schema, 2018-03-15](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/schemas/pge-share-my-data-click-thru-2.0-retailcustomer-20180315.xsd) - [Green Button Alliance ESPI OpenAPI](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/openapi/green-button-alliance-espi-openapi.json): the STANDARD contract PG&E implements, harvested from the Green Button Alliance. NOT authored by PG&E; its declared server is the GBA sandbox. - [MeterReadings example payload (ZIP)](https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/MeterReadings_Example.zip) ## API Evangelist artifacts - [Authentication profile](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/authentication/pge-authentication.yml): OAuth 2.0 over mandatory mutual TLS 1.2; three token classes; no OIDC. - [OAuth scopes](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/scopes/pge-scopes.yml): the full ESPI function-block scope-string model (FB=1 through FB=47 plus AdditionalScope). - [API conventions](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/conventions/pge-conventions.yml): Atom/XML, Zulu-only date-range filtering, x-transaction tracing, no idempotency contract. - [Error catalog](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/errors/pge-problem-types.yml) - [Rate limits](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/rate-limits/pge-rate-limits.yml): 1 request/second per vendor, 2,000/hour and 20,000/24h per client ID. - [Webhook / notification catalog](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/asyncapi/pge-share-my-data-notifications.yml) - [Sandbox and mandatory testing](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/sandbox/pge-sandbox.yml) - [Lifecycle](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/lifecycle/pge-lifecycle.yml) and [changelog](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/changelog/pge-changelog.yml) - [Data model](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/data-model/pge-data-model.yml) - [Conformance](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/conformance/pge-conformance.yml) and [domain security](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/security/pge-domain-security.yml) - [Agent skills](https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/skills/_index.yml) ## Regulatory context - [California SB 1476 / Public Utilities Code section 8380](http://docs.cpuc.ca.gov/PublishedDocs/PUBLISHED/Graphics/140370.PDF) - [CISR-SMD tariff form 79-1186](https://www.pge.com/tariffs/assets/pdf/tariffbook/ELEC_FORMS_79-1186.pdf): Cal. P.U.C. Sheet 55826-E, Advice 6900-E, effective 2023-04-01. - [Energy Data Request Program](https://pge-energydatarequest.com/): quarterly aggregated ZIP-code electric and gas usage datasets under CPUC D.14-05-016 — form-gated CSV-in-ZIP downloads, NOT an API. ## Notes for agents - There is no self-serve access. Do not attempt to obtain credentials programmatically; registration is a screened, approval-gated business process. - Every production call requires a client X.509 certificate over mutual TLS in addition to the bearer token. An anonymous call returns HTTP 400 "Invalid Certificate". - Dates in query parameters must be Zulu (UTC). Other formats are rejected. - Responses are Atom/XML, not JSON. There is no JSON representation of ESPI resources. - PG&E publishes no MCP server, no GraphQL, no Postman collection and no first-party OpenAPI.