# PG&E Usage API

**Canonical:** https://apis.io/apis/pge/pg-and-e-usage-api/  
**Provider:** Pacific Gas and Electric — https://apis.io/providers/pge/  
**Base URL:** https://api.pge.com  
**Documentation:** https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html

PG&E Usage API is one of 7 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 Usage. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Retrieve energy usage interval data.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionId}/UsagePoint` | List usage points |
| GET | `/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionId}/UsagePoint/{usagePointId}/MeterReading` | List meter readings |
| GET | `/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionId}/UsagePoint/{usagePointId}/MeterReading/{meterReadingId}/IntervalBlock` | List interval blocks |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/openapi/pg-and-e-usage-api-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/overlays/pg-and-e-usage-api-overlay.yaml
- **Documentation** — https://www.pge.com/en/save-energy-and-money/energy-saving-programs/smartmeter/third-party-companies.html
- **APIReference** — https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-APIs.pdf
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/authentication/pg-and-e-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/pge/refs/heads/main/scopes/pg-and-e-scopes.yml

## Other Pacific Gas and Electric APIs (6)

- [PG&E Share My Data OAuth 2.0 Authorization API](https://apis.io/apis/pge/pge-share-my-data-oauth-api/)
- [Pacific Gas and Electric Application Information API](https://apis.io/apis/pge/pge-applicationinformation-api/)
- [Pacific Gas and Electric Authorization API](https://apis.io/apis/pge/pge-authorization-api/)
- [Pacific Gas and Electric Batch API](https://apis.io/apis/pge/pge-batch-api/)
- [Pacific Gas and Electric Usage Point API](https://apis.io/apis/pge/pge-usagepoint-api/)
- [PG&E Subscriptions API](https://apis.io/apis/pge/pg-and-e-subscriptions-api/)

## Tags

Usage

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pge/pg-and-e-usage-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pge/.