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.19'
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
  - 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