aid: naesb url: https://raw.githubusercontent.com/api-evangelist/naesb/refs/heads/main/apis.yml name: NAESB kind: company description: >- The North American Energy Standards Board (NAESB) is the non-profit, industry-consensus standards development organization formed in 1994 that writes the business practice standards for the North American wholesale and retail natural gas and electricity markets, organized into four quadrants — Wholesale Electric (WEQ), Retail Electric (REQ), Wholesale Gas (WGQ) and Retail Gas (RGQ). Headquartered in Houston, Texas, its home market is the United States (with Canadian and Mexican participation). NAESB sits upstream of every utility, ISO/RTO and energy-data platform in the value chain: it authors REQ.21 Energy Services Provider Interface (ESPI), the standard that is the basis of every Green Button implementation in North America, and it operates the NAESB Electric Industry Registry (EIR) that underpins electronic tagging across the wholesale electric market. Its API posture is deliberately split and must not be overstated. NAESB is not a data holder and no consumer-data mandate applies to it; the Green Button standard it publishes is adopted by US utilities purely voluntarily, with no federal obligation behind it. The specifications themselves are copyright-protected and paywalled — $8,000/year membership, $2,000 per quadrant version, or $250 per individual standard — with only a free, view-only, three-business-day evaluation waiver for non-members. The single genuinely open artifact is the set of ESPI XML schemas, released under Apache 2.0 as a documented one-time exception to the NAESB Copyright Policy and downloadable anonymously after a one-click terms-of-use acknowledgement. The one real API NAESB operates, the EIR webRegistry SOAP service administered by OATI, is closed: it requires a paid registry subscription and a digitally signed X.509 certificate issued by an NAESB-Authorized Certification Authority, and its endpoint could not even complete a TLS handshake anonymously. Open standard schemas, closed standards text, closed registry API, no consumer data and no open market data of its own. accessModel: pricing: paid onboarding: application-approval trial: true try_now: false public: false label: Paid membership or per-document purchase · Registry API requires accredited certificate confidence: high source: - https://www.naesb.org/ESPI_Standards.asp - https://www.naesb.org//misc/naesb_matl_order_espi_standards.pdf - https://www.naesb.org//misc/NAESB_Nonmember_Evaluation.pdf - https://www.naesb.org/pdf4/eir_webregistry_technical_guide_v6.1_1018.pdf generated: '2026-07-27' method: manual image: https://www.naesb.org/images/naesb-logo.jpg tags: - Energy - United States - Standards - Utilities - Electricity - Gas - Green Button - Smart Metering - Energy Markets - Grid created: '2026-07-27' modified: '2026-07-27' specificationVersion: '0.19' enrichment: round: '2026-07-27' note: >- Contract discovery upgraded this repo. The prior round recorded that the EIR webRegistry endpoint could not complete a TLS handshake anonymously. That was a trust-chain failure, not a handshake failure: the server certificate is issued by OATI's private webCARES Server Issuing CA and does not chain to a public root. Once that is accounted for, the host answers, the full 30-operation WSDL is served to anonymous callers, and the service returns a well-formed SOAP refusal ("Please present a valid certificate that is associated with a NAESB EIR user") rather than nothing at all. The WSDL is now harvested verbatim and is this provider's real machine-readable contract. apis: - aid: naesb:naesb-espi-green-button name: NAESB REQ.21 Energy Services Provider Interface (ESPI) description: >- The NAESB REQ.21 ESPI Model Business Practices define the data exchange protocol for transferring retail energy usage information from a utility (Data Custodian) to a Third Party with the Retail Customer's authorization. ESPI is the industry-consensus standard that is the basis of every Green Button implementation in North America and is the standard endorsed by the Green Button Alliance. NAESB publishes the standard; it does not operate an ESPI endpoint — each Data Custodian utility hosts its own, so there is no NAESB base URL. The Atom/XML payload schemas (NAESBespiSchema.xsd and retailcustomer.xsd, v3.3 and v4.0) are released under the Apache License 2.0 as a one-time exception to the NAESB Copyright Policy and are harvested here verbatim. The narrative Model Business Practices themselves are copyright-protected and must be purchased or obtained through NAESB membership. The v4.0 schema encodes an OAuth 2.0 authorization model directly — ApplicationInformation carries authorizationServerAuthorizationEndpoint, authorizationServerTokenEndpoint, authorizationServerRegistrationEndpoint, GrantType, TokenEndPointMethod, scope and OAuthError. humanURL: https://www.naesb.org/ESPI_Standards.asp tags: - Green Button - ESPI - Energy Usage - Smart Metering - OAuth - Retail Electric properties: - type: XMLSchema url: schemas/naesb-espi_v4.xsd - type: XMLSchema url: schemas/naesb-customer_v4.xsd - type: XMLSchema url: schemas/naesb-espi.xsd - type: XMLSchema url: schemas/naesb-customer.xsd - type: Documentation url: https://www.naesb.org/ESPI_Standards.asp - type: Pricing url: https://www.naesb.org//misc/naesb_matl_order_espi_standards.pdf - type: TermsOfService url: https://www.naesb.org/copyright.asp - type: AgentSkill name: Authorize and retrieve Green Button energy usage under NAESB ESPI url: skills/naesb-espi-green-button-authorization.md - aid: naesb:naesb-eir-webregistry name: NAESB Electric Industry Registry (EIR) webRegistry Web Services description: >- The NAESB Electric Industry Registry is the central repository of registry information used by the North American wholesale electric industry for electronic tagging; it replaced the NERC TSIN in 2012 and is administered for NAESB by Open Access Technology International (OATI) as OATI webRegistry. It exposes a documented SOAP 1.1 web service with methods including DownloadEntity, DownloadBA, DownloadPSE and DownloadACA, described across the 121-page OATI webRegistry Technical Guide v6.1. The service is HTTPS-only, and per section 2.5 of that guide no request is processed unless it carries a digitally signed certificate associated with a registered webRegistry user; those certificates are issued by NAESB-Authorized Certification Authorities. Access also requires a paid registry subscription. The full WSDL — one service, one portType and thirty Download* operations over thirty entity structs — IS served to anonymous callers and is harvested here verbatim. Two things complicate reaching it: the server certificate is issued by OATI's private "webCARES Server Issuing CA 2025" and does not chain to a public root, so default trust stores fail verification (curl exit 60); and once that is accounted for, an anonymous SOAP call returns HTTP 200 with ReturnCode 1 / FAILURE and the message "Please present a valid certificate that is associated with a NAESB EIR user". The contract is public; the data behind it is not. humanURL: https://www.naesb.org/weq/weq_eir.asp baseURL: https://www.naesbwry.oati.com/cgi-bin/webplus.dll?Script=/naesbwry/WREG-Web-Services-Main.wml tags: - Registry - Wholesale Electric - SOAP - E-Tagging - Grid properties: - type: Documentation url: https://www.naesb.org/weq/weq_eir.asp - type: TechnicalGuide url: https://www.naesb.org/pdf4/eir_webregistry_technical_guide_v6.1_1018.pdf - type: APIReference url: https://www.naesb.org/pdf4/eir_webregistry_technical_guide_v6.1_1018.pdf - type: UserGuide url: https://www.naesb.org/pdf4/eir_webregistry_user_guide_v5.0_1023.pdf - type: GettingStarted url: https://www.naesb.org/pdf4/eir_webregistry_quick_start_guide_v3.0_1023.pdf - type: FAQ url: https://www.naesb.org/pdf4/eir_user_interface_faq_0921.pdf - type: Pricing url: https://www.naesb.org/pdf4/naesb_eir_subscription_fee010715.docx - type: Authentication url: https://www.naesb.org/pdf4/ac_authorities_2023.pdf - type: WSDL url: wsdl/naesb-eir-webregistry.wsdl - type: ChangeLog url: https://www.naesb.org/weq/weq_eir.asp - type: Roadmap url: https://www.naesb.org/weq/weq_eir_requests.asp - type: AgentSkill name: Download a NAESB EIR registry publication url: skills/naesb-download-eir-registry.md common: - type: DomainSecurity url: security/naesb-domain-security.yml - type: Website url: https://www.naesb.org/ - type: About url: https://www.naesb.org/aboutus.asp - type: ContactUs url: https://www.naesb.org/contactus.asp - type: Documentation url: https://www.naesb.org/ESPI_Standards.asp - type: Tools url: https://www.naesb.org/naesb_tools.asp - type: Certification url: https://www.naesb.org/materials/certification.asp - type: CertifiedProducts url: https://www.naesb.org/pdf2/cert_products.pdf - type: CertificationAuthorities url: https://www.naesb.org/pdf4/ac_authorities_2023.pdf - type: Pricing url: https://www.naesb.org/pdf/ordrform.pdf - type: Licensing url: https://www.naesb.org/copyright.asp - type: TermsOfService url: https://www.naesb.org/pdf4/terms&conditions.pdf - type: PrivacyPolicy url: https://www.naesb.org/privacy.asp - type: Membership url: https://www.naesb.org/membership.asp - type: Newsletter url: https://www.naesb.org/bulletin_newsletter.asp - type: PressReleases url: https://www.naesb.org/news.asp - type: WhitePapers url: https://www.naesb.org/white_papers.asp - type: Support url: https://www.naesb.org/contactus.asp - type: Compliance url: https://www.naesb.org/materials/certification.asp - type: Authentication url: authentication/naesb-authentication.yml - type: Conventions url: conventions/naesb-conventions.yml - type: ErrorCatalog url: errors/naesb-error-codes.yml - type: Lifecycle url: lifecycle/naesb-lifecycle.yml - type: ChangeLog url: changelog/naesb-changelog.yml - type: Conformance url: conformance/naesb-conformance.yml - type: DataModel url: data-model/naesb-data-model.yml - type: LLMsTxt url: llms/naesb-llms.txt - type: AgentSkill url: skills/_index.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com