# Con Edison Green Button Connect My Data API

**Canonical:** https://apis.io/apis/con-edison/con-edison-green-button-connect-my-data-api/  
**Provider:** Con Edison — https://apis.io/providers/con-edison/  
**Base URL:** https://api.coned.com/gbc/espi/1_1  
**Documentation:** https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party

Con Edison Green Button Connect My Data API is one of 2 APIs that [Con Edison](https://apis.io/providers/con-edison/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Green Button, Connect My Data, ESPI, Energy Usage, and Billing. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, rate-limit docs, a getting-started guide, and API documentation.

Con Edison and Orange & Rockland's Green Button Connect My Data (CMD) implementation, branded "Share My Data" — the NAESB REQ.21 Energy Services Provider Interface (ESPI) machine-to-machine API through which a customer- authorized third party retrieves that customer's electric and gas interval usage, usage summaries, billing information and retail customer records in Atom/ESPI XML. The published Swagger 2.0 definition ("DCX GBC API V2", basePath /gbc/espi/1_1) documents 37 paths across ApplicationInformation, Authorization, ReadServiceStatus, UsagePoint, MeterReading, IntervalBlock, ReadingType, LocalTimeParameters, UsageSummary, RetailCustomer, Batch and RealTime resources. Authorization is OAuth 2.0 (RFC 6749/6750): the customer consents on the Con Edison or ORU site, the third party exchanges the authorization code at the token endpoint, and access tokens live one hour. Scopes are ESPI functional blocks (FB=1_3_4_5_7_8_10_15_16_51_53_56_ 57_58_60 with IntervalDuration, BlockDuration and HistoryLength qualifiers). Up to two years of history; 5-minute intervals for commercial AMI electric, 15-minute for residential AMI electric, 1-hour for gas AMI, monthly for non-interval meters; real-time electric readings for the last 24 hours at 45-minute latency. Access is NOT self-serve — registration, a signed Data Security Agreement, a technical onboarding form and supervised test-environment certification are required before production credentials are issued.

## Machine-readable artifacts (27)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/openapi/con-edison-green-button-connect-my-data-swagger.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/overlays/con-edison-green-button-connect-my-data-overlay.yaml
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/collections/con-edison-green-button-connect-my-data.postman_collection.json
- **PostmanEnvironment** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/collections/con-edison-green-button-connect-my-data.postman_environment.json
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/authentication/con-edison-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/scopes/con-edison-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/conventions/con-edison-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/errors/con-edison-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/rate-limits/con-edison-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/lifecycle/con-edison-lifecycle.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/conformance/con-edison-conformance.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/data-model/con-edison-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/asyncapi/con-edison-batch-notification-webhooks.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/sandbox/con-edison-sandbox.yml
- **MCPServer** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/mcp/con-edison-mcp.yml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/skills/_index.yml
- **GettingStarted** — https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
- **Documentation** — https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
- **Documentation** — https://www.coned.com/-/media/files/coned/documents/accountandbilling/share-my-data/onboarding-doc.pdf
- **FAQ** — https://www.coned.com/-/media/files/coned/documents/accountandbilling/share-my-data/faq.pdf
- **SignUp** — https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party/registration-form
- **Documentation** — https://www.coned.com/en/business-partners/access-customer-data
- **Documentation** — https://www.coned.com/en/accounts-billing/share-energy-usage-data/share-my-data
- **Documentation** — https://www.coned.com/en/accounts-billing/share-energy-usage-data/share-my-data/share-my-data-faq
- **Standard** — https://www.naesb.org/espi_standards.asp
- **Standard** — https://www.greenbuttonalliance.org/green-button-connect-my-data-cmd
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/apis.yml

## Other Con Edison APIs (1)

- [Con Edison Hosting Capacity Map REST API](https://apis.io/apis/con-edison/con-edison-hosting-capacity-map-rest-api/)

## Tags

Green Button, Connect My Data, ESPI, Energy Usage, Billing, Smart Metering, Authentication

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/con-edison/con-edison-green-button-connect-my-data-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/con-edison/.