# Southern California Edison (SCE)

> Regulated electric utility subsidiary of Edison International serving ~15 million people across a 50,000 square-mile territory in central, coastal and southern California. SCE's API posture splits in two: the CPUC-mandated customer-data interface (Green Button Connect My Data) is real but entirely closed to the open web, while its grid data (Distribution Resources Plan External Portal, DRPEP) is served over an anonymous, key-free Esri ArcGIS REST catalog that any developer can query today. This file was generated by API Evangelist on 2026-07-27 from live probes and the artifacts in this repository; SCE publishes no llms.txt, no developer portal and no OpenAPI.

## What you can actually call

- [SCE DRPEP ArcGIS REST Services](https://drpep.sce.com/arcgis_server/rest/services/Hosted?f=json): Anonymous, unauthenticated. 15 hosted FeatureServers, 47 feature layers and 11 tables of Integration Capacity Analysis, distribution circuits, substations, Grid Needs Assessment, Distribution Deferral Opportunity Report, Locational Net Benefit Analysis, PSPS boundaries, CPUC fire-threat tiers, transmission projects and load heat maps. No key, no registration, no quota.
- [DRPEP portal](https://drpep.sce.com/drpep/): The Esri Experience Builder app over those services.
- [DRPEP open data site](https://drpep-sce2.opendata.arcgis.com/): ArcGIS Hub site publishing the same 47 datasets as CSV, GeoJSON, KML and Shapefile, with DCAT-US 1.1 and DCAT-AP 2.1.1 catalog feeds.

## What you cannot call without registering

- [Green Button Connect My Data / Customer Data Access](https://www.sce.com/partners/3rd-party-energy-providers/access-energy-usage-data): Mandated by CPUC tariff Rule 26 (Advice 3087-E, effective 2014-08-29, implementing D.14-05-016). SCE states third parties need OAuth 2.0 and bulk-API capability "consistent with the standard adopted by the North American Energy Standards Board (NAESB)". No base URI, endpoint list, scope list, OpenAPI or sandbox is published anywhere. Access requires registering a Third Party User ID, supplying a Taxpayer Identification Number, accepting the Third Party Registration Terms & Conditions, and passing an SCE-run machine-to-machine connectivity test.
- [Third-party registration](https://www.sce.com/user-registration?userType=4): The registration funnel. There is no developer portal on any sce.com subdomain.
- [Rule 24 demand response FAQs](https://www.sce.com/partners/3rd-party-energy-providers/rule-24-faqs): The separate, also-gated lane for demand response providers.
- [Energy Data Request Program](https://www.sce.com/partners/partnerships/edrp): The government/research lane; the page renders behind an Okta-gated shell.

## Specs and artifacts in this repository

- [OpenAPI for the DRPEP ArcGIS surface](openapi/southern-california-edison-drpep-arcgis-openapi.yml): OpenAPI 3.1, 8 operations, generated by API Evangelist from live anonymous probes. NOT published by SCE.
- [Overlay](overlays/southern-california-edison-drpep-arcgis-overlay.yaml): API Evangelist assessment layer over that spec.
- [JSON Schema](json-schema/southern-california-edison-drpep-layers-schema.json): Attribute schemas for 11 marquee layers and tables, derived from live ArcGIS layer descriptors.
- [Data model](data-model/southern-california-edison-data-model.yml): 58 entities, 13 relationships, joined on circuit_name / substation_name / system_name / node_id / section_id / gna_id.
- [Conventions](conventions/southern-california-edison-conventions.yml): f=json content negotiation, offset pagination, exceededTransferLimit, SQL-92 where clauses, no rate-limit headers.
- [Error codes](errors/southern-california-edison-error-codes.yml): The ArcGIS error envelope, returned with HTTP 200 - observed codes 404, 499 and 500.
- [Authentication](authentication/southern-california-edison-authentication.yml): None for DRPEP; OAuth 2.0 claimed-but-undisclosed for Green Button; Okta OIDC discovery for the login estate.
- [Conformance](conformance/southern-california-edison-conformance.yml): ArcGIS REST, GeoJSON, DCAT-US/DCAT-AP verified; NAESB ESPI and OAuth 2.0 claimed only; no OGC API - Features, no RFC 9457, no security.txt.
- [Lifecycle](lifecycle/southern-california-edison-lifecycle.yml): No versioning policy, no deprecation policy, no SLA, no API status page; data vintage is published in-band via FGDB DATE TIME tables.
- [Domain security](security/southern-california-edison-domain-security.yml): TLS 1.3 on both hosts, HSTS on www.sce.com only, SPF and DMARC (quarantine) on sce.com, no DNSSEC, no CAA.
- [Well-known](well-known/southern-california-edison-well-known.yml): Nothing on SCE's own hosts; only the sce.okta.com OIDC and RFC 8414 documents.
- [Agent skills](skills/_index.yml): Packaged instructions for querying hosted capacity, circuit constraints, and PSPS/fire exposure.
- [ArcGIS descriptors](arcgis/): The raw service, layer and catalog documents saved verbatim as fetched.

## How to query it (verified 2026-07-27)

- Count features: `https://drpep.sce.com/arcgis_server/rest/services/Hosted/ICA_Layer/FeatureServer/0/query?where=1%3D1&returnCountOnly=true&f=json` -> `{"count":676467}`
- One circuit's segments: `.../ICA_Layer/FeatureServer/0/query?where=circuit_name%3D%27Acapulco%27&outFields=*&returnGeometry=false&f=json`
- GeoJSON output: append `&f=geojson`
- Page: `&resultOffset=0&resultRecordCount=2000`, then follow `exceededTransferLimit`
- Errors arrive with HTTP 200 and an `error` object - check the body, not the status line.

## Company

- [Website](https://www.sce.com/)
- [Privacy notice](https://www.sce.com/privacy)
- [Customer Data Access terms & conditions](https://www.sce.com/terms-conditions/customer-data-access-terms-conditions)
- [Rule 26 tariff (PDF)](https://www.sce.com/sites/default/files/inline-files/Rule26.pdf)
- [Energy data reports and compliances](https://www.sce.com/regulatory/regulatory-information/energy-data-reports-compliances)
- [Edison International newsroom](https://newsroom.edison.com/)
- [LinkedIn](https://www.linkedin.com/company/sce)
- Contacts: GreenButton@sce.com (Green Button), 3RDPARTY@sce.com (third parties), Rule24Support@sce.com (demand response), EnergyDataRequest_EDRP@sce.com (research/government)