NAESB Electric Industry Registry (EIR) webRegistry Web Services

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.

API entry from apis.yml

apis.yml Raw ↑
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