pg-and-e website screenshot

pg-and-e

Pacific Gas and Electric Company (PG&E) is one of the largest combined natural gas and electric energy companies in the United States, serving approximately 16 million people in northern and central California. PG&E offers the Share My Data API, a Green Button Connect My Data implementation providing customer- authorized access to energy usage interval data for both electricity and gas through RESTful web services.

pg-and-e publishes 3 APIs on the APIs.io network: Authorization API, Subscriptions API, and Usage API.

pg-and-e’s developer surface includes authentication and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub
30.4/100 thin ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
3 APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 30.4/100 · thin
Contract Quality 13.1 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 3.4 / 13
Governance 0.0 / 12
Discoverability 5.9 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/pg-and-e: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

pg-and-e Authorization API

OAuth 2.0 authorization for customer data access.

pg-and-e Subscriptions API

Manage data subscriptions for customer accounts.

pg-and-e Usage API

Retrieve energy usage interval data.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

PG&E Share My Data API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Pg And E Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Pg And E Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Pg And E Finops

FINOPS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Pg And E Authentication

oauth2 · 1 scheme

SECURITY

Pg And E Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Pg And E Scopes

1 scope · authorizationCode

1 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Pg And E Agentic Access

5 operations

5 operations · 0 acting

AGENTIC

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Website
Website

Other 1

Properties that don't map to a standard resource type

Share My Data
Share My Data

Source (apis.yml)

apis.yml Raw ↑ 
aid: pg-and-e
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/pg-and-e.png
url: https://raw.githubusercontent.com/api-evangelist/pg-and-e/refs/heads/main/apis.yml
modified: '2026-05-19'
apis:
- aid: pg-and-e:pg-and-e-authorization-api
  name: pg-and-e Authorization API
  description: OAuth 2.0 authorization for customer data access.
  humanURL: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
  baseURL: https://api.pge.com
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/pg-and-e-authorization-api-openapi.yml
  - type: Documentation
    url: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
- aid: pg-and-e:pg-and-e-subscriptions-api
  name: pg-and-e Subscriptions API
  description: Manage data subscriptions for customer accounts.
  humanURL: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
  baseURL: https://api.pge.com
  tags:
  - Subscriptions
  properties:
  - type: OpenAPI
    url: openapi/pg-and-e-subscriptions-api-openapi.yml
  - type: Documentation
    url: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
- aid: pg-and-e:pg-and-e-usage-api
  name: pg-and-e Usage API
  description: Retrieve energy usage interval data.
  humanURL: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
  baseURL: https://api.pge.com
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/pg-and-e-usage-api-openapi.yml
  - type: Documentation
    url: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
common:
- type: AgenticAccess
  url: agentic-access/pg-and-e-agentic-access.yml
- type: DomainSecurity
  url: security/pg-and-e-domain-security.yml
- type: Authentication
  url: authentication/pg-and-e-authentication.yml
- type: OAuthScopes
  url: scopes/pg-and-e-scopes.yml
- type: GitHubOrganization
  url: https://github.com/pgetech
- type: LinkedIn
  url: https://www.linkedin.com/company/pacificgasandelectric
- type: Share My Data
  url: https://www.pge.com/en/save-energy-and-money/energy-usage-and-tips/understand-my-usage/share-my-data.html
- type: Website
  url: https://www.pge.com/
description: Pacific Gas and Electric Company (PG&E) is one of the largest combined natural gas and electric energy companies
  in the United States, serving approximately 16 million people in northern and central California. PG&E offers the Share
  My Data API, a Green Button Connect My Data implementation providing customer- authorized access to energy usage interval
  data for both electricity and gas through RESTful web services.