This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.
Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema,
apis.json,llms.txtand similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.
Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.
- Something wrong? Open an issue on this repository, or email info@apievangelist.com.
- Published something new? Ask for a re-score and we will re-run the rating.
- Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.
Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.
Not from the company, and here with a question? You are welcome here — we would rather be the front line and point you the right way than have a good report go nowhere. What this repository can answer is narrow, though, so it is worth knowing who you are actually looking for:
- A question about how the API works, an account, billing, or a bug in the service — that is the company's own support, not us. We profile this API; we do not operate it and cannot see your account.
- A bug in an open-source project we only catalog — file it on that project's own repository. This has happened with a real and correct bug report that reached us instead of the people who could fix it, which helped nobody.
- Anything about this listing itself — the description, the tags, the rating, a missing or wrong artifact — is ours. Open an issue here.
- Not sure, or something general about API Evangelist or APIs.io — open an issue on the APIs.io Inbox and we will route it.
This repository contains no software, and we will never ask you to download anything. There is no build, release, installer, or binary here — only text and machine-readable API descriptions, so there is nothing here that can be "corrupt" or need "repairing". Any issue, comment, or email claiming otherwise and offering a download link is not from us and is hostile. Do not follow the link; it is a lure. Report it to GitHub and, if you like, tell us at info@apievangelist.com so we can take it down.
On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.
Full detail: Where this data comes from
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.
APIs.json: https://raw.githubusercontent.com/api-evangelist/con-edison/refs/heads/main/apis.yml
- 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日
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.
- Human URL: https://www.coned.com/en/accounts-billing/share-energy-usage-data/become-a-third-party
- Base URL:
https://api.coned.com/gbc/espi/1_1
- OpenAPI — Swagger 2.0, harvested verbatim
- Postman Collection — "GBC Certification Third party V3.3"
- Postman Environment
- Documentation — become a third party
- Documentation — Third-Party Technical Onboarding Document (PDF, v4.4, updated 2026年05月07日)
- FAQ — Share My Data FAQ for Third Party Vendors (PDF)
- Sign Up — Third-Party Company Registration Form
- Standard — NAESB REQ.21 ESPI
- Standard — Green Button Connect My Data
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." Coverage includes CECONY and ORU segmented and network hosting capacity, 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 layers. No login, key, or agreement required.
- Human URL: https://www.coned.com/en/business-partners/hosting-capacity
- Base URL:
https://services.arcgis.com/ciPnsNFi1JLWVjva/arcgis/rest/services
- Documentation — Hosting Capacity
- Documentation — About the Hosting Capacity Map
- Application — Hosting Capacity Web Experience
- API Reference — CECONY_NodalHCV_Prod
- API Reference — CECONY_EVM_Prod
- API Reference — CE_NWS_Networks_Prod
- API Reference — IEDR_CECONY
- Mandate regime:
green-button-voluntary. The United States has no federal energy consumer data right, and nothing equivalent to Australia's Consumer Data Right (energy) or Ontario Regulation 633/21 applies. Qualification, recorded so this is not read as pure voluntarism: Con Edison committed to implement the first phase of Green Button Connect by end of 2017 in the Joint Utilities' Supplemental DSIP (NY PSC Case 16-M-0411); the Commission issued an Order Adopting a Data Access Framework in Case 20-M-0082 (2021年04月15日); and Con Edison's own FAQ binds third parties to "the requirements set forth in the Customer Data Access Tariff." That is state-regulator supervision of a voluntary standard — not a consumer data right. - Mandate status:
live-implemented, and verified rather than taken on trust. The documented production base URIhttps://api.coned.com/gbc/espi/1_1/resource/ReadServiceStatusreturned HTTP 401 anonymously on 2026年07月27日, andPOST /gbc/espi/1_1/oauth/Tokenwithout credentials returned{"Message":"Unauthorized. Access token is missing or invalid."}. A 37-path Swagger 2.0 contract for that exact base path is published by Con Edison and parses. A Postman collection named "GBC Certification Third party V3.3" ships alongside it. The onboarding document is at version 4.4, last revised 2026年05月07日. Not verified: Green Button Alliance certification from a primary GBA source — the GBA certification page publishes no directory and lists Con Edison only as a sponsor member. - Data standard: Green Button Connect My Data — NAESB REQ.21 ESPI. Version evidence: base path
/gbc/espi/1_1(ESPI 1.1), Swagger title "DCX GBC API V2", Postman collection "GBC Certification Third party V3.3". Atom/ESPI XML payloads; OAuth 2.0 per RFC 6749 with Bearer tokens per RFC 6750. Real-time endpoints are a documented extension "even though they are not part of the GBC V3.3 Standard." No CDR, OCPP, OCPI, OpenADR, IEEE 2030.5 or IEC CIM reference found. The grid-data side uses no energy standard — it is Esri ArcGIS REST. - Consumer data API: Yes. Customer-authorized third parties retrieve electric and gas interval usage (5-minute commercial AMI, 15-minute residential AMI, 1-hour gas AMI, monthly non-interval), usage summaries, billing information and retail customer records, up to 2 years of history, plus electric-only real-time readings for the last 24 hours at 45-minute latency. Consent is customer-chosen, revocable, and auto-revoked after 365 days of inactivity.
- Market data open: Yes on the distribution-grid axis, anonymously and with no agreement — hosting capacity, EV transformer headroom, non-wires-solutions networks, 33kV feeders, LSRV eligibility and the IEDR layers, all HTTP 200 unauthenticated over ArcGIS REST. This is grid/system data, not wholesale market data; NYISO and EIA publish that, and none of it is claimed here. There is no
data.coned.comand no open data portal. - Access gate:
application-approval. To reach customer data a developer must complete the Third-Party Company Registration Form, sign the Data Security Agreement and accept terms, submit a technical onboarding form (all URLs reachable from Con Edison's network, TLS 1.2+), receive credentials by email, build their own customer-authorization portal, pass supervised testing in a test environment they cannot access independently, submit the API testing checklist, and re-register for production. 30–60 days for technical onboarding; 90-day windows on both the DSA and testing; no cost. Con Edison states flatly that it "is unable to support API development for third parties." The Hosting Capacity REST services have no gate at all; Download My Data iscustomer-account-required. - Auth model: OAuth 2.0 (RFC 6749) / Bearer (RFC 6750) over TLS 1.2+. Authorization endpoint on the web property (
https://www.coned.com/en/oauth/authorize), token endpoint on the API host (https://api.coned.com/gbc/espi/1_1/oauth/Token), HTTP Basic client authentication. Grants:authorization_code(1-minute single-use code),refresh_token(1-year idle expiry, refresh token not stored by Con Edison), andclient_credentialsfor the bulk Third-Party Client Access Token. Access tokens live 3600s; 50 token calls/minute. Scopes are ESPI functional blocks, e.g.FB=1_3_4_5_7_8_10_15_16_51_53_56_57_58_60;IntervalDuration=...;BlockDuration=...;HistoryLength=63072000;BR=<BulkId>. The Swagger declares nosecurityDefinitions;/.well-known/openid-configurationreturns 404. The ArcGIS services require no auth. - Home market: United States — New York (NYC and Westchester; ORU covers parts of NY, NJ and PA).
The split is the finding: the same company serves its grid data to anyone anonymously, and requires a signed contract plus per-customer OAuth consent for a single interval reading. Full probe log, HTTP statuses, and evidence are recorded in review.yml.
- Website
- About
- Parent Company — Consolidated Edison, Inc.
- Documentation — how to access customer data
- Documentation — share energy usage data
- Documentation — Green Button Download My Data
- Sign Up — Third-Party Company Registration Form
- Authentication — account dashboard
- Privacy Policy
- Terms of Service
- Email — Share My Data technical onboarding team
- Regulator — New York State Department of Public Service
- Standard — Green Button Alliance
- Standard — NAESB ESPI
- Sister Company — Orange & Rockland Green Button Connect My Data
- Kin Lane — kin@apievangelist.com