Con Edison

aid: con-edison
url: https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/apis.yml
name: Con Edison
kind: company
description: 'Consolidated Edison Company of New York, Inc. (CECONY, trading as Con Edison) is the investor-owned electric,
  gas and steam utility that serves New York City and Westchester County, and together with its sibling Orange & Rockland
  Utilities (ORU) forms the regulated utility core of Consolidated Edison, Inc. It is a wires-and-pipes distribution utility
  rather than a competitive retailer: it owns and operates the distribution system, meters the customer and bills the customer,
  while wholesale energy markets are run by NYISO and competitive supply is sold by ESCOs. It is rate-regulated by the New
  York State Public Service Commission. Its API posture is the most interesting in the United States sample because both halves
  are real and they are gated completely differently. On the consumer side Con Edison runs a genuine, verified Green Button
  Connect My Data implementation — the NAESB REQ.21 ESPI standard, branded "Share My Data" — with a live production base URI
  at https://api.coned.com/gbc/espi/1_1 that answers anonymously with HTTP 401 "Unauthorized. Access token is missing or invalid.",
  a publicly downloadable 37-path Swagger 2.0 definition ("DCX GBC API V2"), a public Postman collection titled "GBC Certification
  Third party V3.3", OAuth 2.0 authorization-code and client-credentials flows, ESPI functional-block scopes, batch and real-time
  interval endpoints, and a 35-page technical onboarding document last revised 2026-05-07. The United States has no federal
  energy consumer data right; Con Edison''s adoption sits under New York PSC supervision (the Joint Utilities DSIP proceeding,
  Case 16-M-0411, in which it committed to implement the first phase of GBC by end of 2017, the Data Access Framework in Case
  20-M-0082, and a Customer Data Access Tariff) rather than under a statutory mandate like Australia''s Consumer Data Right
  or Ontario Regulation 633/21. That data is not self-serve: a third party must register, sign a Data Security Agreement,
  submit a technical onboarding form and pass 30 to 60 days of supervised testing before production credentials are issued,
  and Con Edison states plainly that it "is unable to support API development for third parties." On the market side, by contrast,
  Con Edison publishes distribution-grid data openly and anonymously: the Hosting Capacity Map documents REST API access,
  and its ArcGIS feature services for segmented and network hosting capacity, EV transformer capacity, 33kV feeders, non-wires-solutions
  networks and disadvantaged communities all answer unauthenticated. Open on the grid, accredited on the customer — that split
  is the finding.'
accessModel:
  pricing: free
  onboarding: application-approval
  trial: false
  try_now: false
  public: false
  label: Free · Registration, Data Security Agreement and supervised onboarding required
  confidence: high
  source:
  - documentation
  - authentication
  generated: '2026-07-27'
  method: manual
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/groq.png
tags:
- Energy
- United States
- New York
- Utilities
- Electricity
- Gas
- Steam
- Smart Metering
- Green Button
- Energy Data
- Grid
- Distribution
- Hosting Capacity
- Distributed Energy Resources
- Solar
- EV Charging
- Demand Response
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: con-edison:con-edison-green-button-connect-my-data-api
  name: Con Edison Green Button Connect My Data API
  description: '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.'
  humanURL: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
  baseURL: https://api.coned.com/gbc/espi/1_1
  tags:
  - Green Button
  - Connect My Data
  - ESPI
  - Energy Usage
  - Billing
  - Smart Metering
  - Authentication
  tags_raw:
  - Green Button
  - Connect My Data
  - ESPI
  - Energy Usage
  - Billing
  - Smart Metering
  - OAuth 2.0
  properties:
  - type: OpenAPI
    url: openapi/con-edison-green-button-connect-my-data-swagger.json
  - type: Overlay
    url: overlays/con-edison-green-button-connect-my-data-overlay.yaml
    name: API Evangelist enhancements — real host, documented OAuth 2.0 schemes, async batch semantics
  - type: PostmanCollection
    url: collections/con-edison-green-button-connect-my-data.postman_collection.json
  - type: PostmanEnvironment
    url: collections/con-edison-green-button-connect-my-data.postman_environment.json
  - type: Authentication
    url: authentication/con-edison-authentication.yml
    name: OAuth 2.0 authorization_code, refresh_token and client_credentials profile
  - type: OAuthScopes
    url: scopes/con-edison-scopes.yml
    name: ESPI functional-block scopes (FB=1,3,4,5,7,8,10,15,16,35,51,53,56,57,58,60,67)
  - type: Conventions
    url: conventions/con-edison-conventions.yml
  - type: ErrorCatalog
    url: errors/con-edison-problem-types.yml
  - type: RateLimits
    url: rate-limits/con-edison-rate-limits.yml
    name: 50 token-endpoint calls per minute; no limit on resource endpoints
  - type: Lifecycle
    url: lifecycle/con-edison-lifecycle.yml
  - type: Conformance
    url: conformance/con-edison-conformance.yml
    name: NAESB REQ.21 ESPI 1.1, Green Button CMD V3.3, RFC 6749/6750
  - type: DataModel
    url: data-model/con-edison-data-model.yml
  - type: Webhooks
    url: asyncapi/con-edison-batch-notification-webhooks.yml
    name: Batch completion notification POSTed to the third party's ThirdPartyNotifyUri
  - type: Sandbox
    url: sandbox/con-edison-sandbox.yml
    name: Supervised test environment — apit.coned.com and uat10.coned.com
  - type: MCPServer
    url: mcp/con-edison-mcp.yml
    name: Candidate MCP tool list derived from the published Swagger definition (no server exists)
  - type: AgentSkill
    url: skills/_index.yml
  - type: GettingStarted
    url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
  - type: Documentation
    url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
  - type: Documentation
    url: https://www.coned.com/-/media/files/coned/documents/accountandbilling/share-my-data/onboarding-doc.pdf
  - type: FAQ
    url: https://www.coned.com/-/media/files/coned/documents/accountandbilling/share-my-data/faq.pdf
  - type: SignUp
    url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party/registration-form
  - type: Documentation
    url: https://www.coned.com/en/business-partners/access-customer-data
  - type: Documentation
    url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/share-my-data
  - type: Documentation
    url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/share-my-data/share-my-data-faq
  - type: Standard
    url: https://www.naesb.org/espi_standards.asp
  - type: Standard
    url: https://www.greenbuttonalliance.org/green-button-connect-my-data-cmd
- aid: con-edison:con-edison-hosting-capacity-map-rest-api
  name: Con Edison Hosting Capacity Map REST API
  description: Con Edison's distribution-grid open data, published as anonymously readable Esri ArcGIS REST feature services
    behind the public Hosting Capacity Map. Con Edison's own documentation states that "REST API access allows users to overlay
    the Con Edison Hosting Capacity Map data with their own GIS systems and mapping tools" and that the endpoints are exposed
    on the map's "Rest API" tab. The services cover CECONY and Orange & Rockland segmented and network hosting capacity for
    distributed generation, EV load-serving transformer capacity, 33kV feeders, non-wires-solutions impacted networks, Locational
    System Relief Value eligibility, disadvantaged and overburdened communities, and the IEDR-facing hosting capacity layers.
    No login, API key, or agreement is required; every service probed returned HTTP 200 unauthenticated. Con Edison states
    the data "is being provided for informational purposes only and is not intended to be a substitute for the established
    interconnection application process."
  humanURL: https://www.coned.com/en/business-partners/hosting-capacity
  baseURL: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services
  tags:
  - Hosting Capacity
  - Grid
  - Distribution
  - Distributed Energy Resources
  - Solar
  - Storage
  - EV Charging
  - GIS
  - Open Data
  properties:
  - type: Documentation
    url: https://www.coned.com/en/business-partners/hosting-capacity
  - type: Documentation
    url: https://www.coned.com/en/business-partners/hosting-capacity/about
  - type: AgentSkill
    url: skills/con-edison-hosting-capacity-grid-data.md
    name: Query Con Edison hosting capacity and grid data anonymously
  - type: FAQ
    url: https://www.coned.com/en/business-partners/hosting-capacity/faq-page
  - type: Application
    url: https://experience.arcgis.com/experience/d9d758c7736b44909dc3781937ca2ed5
  - type: APIReference
    url: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services/CECONY_NodalHCV_Prod/FeatureServer
  - type: APIReference
    url: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services/CECONY_EVM_Prod/FeatureServer
  - type: APIReference
    url: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services/CE_NWS_Networks_Prod/FeatureServer
  - type: APIReference
    url: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services/CECONY_33Kv_Prod/FeatureServer
  - type: APIReference
    url: https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services/IEDR_CECONY/FeatureServer
common:
- type: AgenticAccess
  url: agentic-access/con-edison-agentic-access.yml
- type: DomainSecurity
  url: security/con-edison-domain-security.yml
- type: AgentSkill
  url: skills/_index.yml
  name: Packaged agent skills for Green Button Connect My Data and the open grid data
- type: Packages
  url: packages/con-edison-packages.yml
  name: No first-party SDKs; one community Python package recorded
- type: LLMsTxt
  url: llms/con-edison-llms.txt
- type: DeveloperPortal
  url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
  name: Become a Third Party — the Share My Data developer-facing portal (not self-serve)
- type: Support
  url: mailto:dlsharemydatatech@coned.com
  name: Share My Data technical onboarding and production-issue support
- type: Website
  url: https://www.coned.com/
- type: About
  url: https://www.coned.com/en/about-us/company-information
- type: ParentCompany
  url: https://www.conedison.com/
- type: Documentation
  url: https://www.coned.com/en/business-partners/access-customer-data
- type: Documentation
  url: https://www.coned.com/en/accounts-billing/share-energy-usage-data
- type: Documentation
  url: https://www.coned.com/en/save-money/make-better-energychoices-with-green-button
  name: Green Button Download My Data
- type: SignUp
  url: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party/registration-form
- type: Authentication
  url: https://www.coned.com/en/accounts-billing/dashboard
- type: PrivacyPolicy
  url: https://www.coned.com/en/conedison-privacy-statement
- type: TermsOfService
  url: https://www.coned.com/en/accounts-billing/dashboard/billing-and-usage/terms-of-use
- type: Email
  url: mailto:dlsharemydatatech@coned.com
  name: Share My Data technical onboarding team
- type: LinkedIn
  url: https://www.linkedin.com/company/con-edison
- type: Regulator
  url: https://dps.ny.gov/
  name: New York State Department of Public Service / Public Service Commission
- type: Standard
  url: https://www.greenbuttonalliance.org/
- type: Standard
  url: https://www.naesb.org/espi_standards.asp
- type: SisterCompany
  url: https://www.oru.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
  name: Orange & Rockland Utilities Green Button Connect My Data
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com