Product Updates
Back to All

Bayou Energy July 2026 Utility API Update

2 days ago by Theo Michel

Overview

  • New Utility Support: Added support for Salt River Project, Colorado Springs Utilities, Dominion Energy North Carolina, and Pedernales Electric Cooperative. This adds over 2.1 million meters, bringing our total coverage to 76% of US electrical meters.
  • More control over automatic bill unlocking: Companies can now automatically unlock only the N most recent bills per customer, and can limit automatic unlocking to electric or gas meters.
  • Dashboard Improvements: Customer status and data availability are now more clear with authentication status and bill count as separate columns.
  • API Improvements:
    • raw (as printed on the bill) meter addresses are now available on the bill and customer endpoints
    • the embedded Bayou onboarding form now exposes more error info via notifications to the hosting page.
  • Bill and Interval Data Improvements:
    • 15 utility-specific "point of delivery" identifiers are now parsed into the additional_attributes field on meters.
    • Parsing and data-quality improvements across 16 utilities, including expanded support for community solar bills.
  • Utility Website Updates: Adapted to portal, login, and MFA changes at five utilities, and made our authentication and data retrieval more resilient at a dozen more.

More info on all of these below, and check out our utility support page for detailed info on our coverage and reliability.

New Utility Coverage

  • Salt River Project — support for authentication, bills, and intervals; adds ~1.3 million electric meters in the Phoenix, Arizona metropolitan area.
  • Colorado Springs Utilities — support for authentication, bills, and 5-minute intervals; adds ~260k electric meters in Colorado.
  • Pedernales Electric Cooperative — support for authentication, bills, and 15-minute intervals; adds ~460k meters in the Texas Hill Country.
  • Dominion Energy North Carolina — support for authentication, bills, and 15-minute intervals; adds ~140k meters in North Carolina.

Automatic Bill Unlocking

When choosing to automatically unlock bills, companies now have finer control over which bills are unlocked, via the company settings page in the dashboard:

  • Most recent N bills — in addition to the options of unlocking all historical bills or a number of recent months, you have the option of unlocking a fixed number of the most recent bills per customer. For newly created companies, the default is now the 12 most recent bills; existing companies keep their current settings.
  • Meter type selection — automatic unlocking can now be limited to electric meters only or gas meters only, in addition to both.

One behavioral note for webhook listeners: for companies using the most-recent-bills mode, new_bill webhooks sent during customer onboarding are now sent as a batch just before bills_ready, so that each new_bill payload can reflect the bill's unlocked state.

Dashboard Improvements

The customer list in the Bayou dashboard previously combined multiple issue types into a single set of statuses, leading to potential confusion about the status of a customer and what data was available. We've simpified the customers list to show two columns:

  • Authentication status — indicates whether the customer is currently connected to get new data. If the customer is not connected, indicates whether the issue happened during onboarding or during a refresh. Clicking into the customer gives a clear indication of what action is needed if any.
  • Bills — a count of the customer's available bills. Clicking into the customer shows the full list of bills with dates and other info as before, so you can see exactly what's available.

API Improvements

Raw meter addresses on bill and customer endpoints

Meter addresses in Bayou responses are normalized by default. Some bills print partial service addresses (for example a street line with no city or state), and normalization of a partial address can occasionally resolve to the wrong location.

For companies that prefer to see exactly what the bill says, the bill endpoints and the /api/v2/customers list and detail endpoints now accept ?return_raw_addresses=true. With the flag set, meter addresses are returned exactly as they were extracted from the customer's bill, instead of the normalized version. When using raw addresses, some address fields (e.g. zip code) may be empty.

Onboarding form error handling

The form also now notifies the hosting page (via the Bayou embed library) of errors using 3 new callbacks:

  • onboardingTokenError — the onboarding token is expired or invalid; mint a fresh token and reload the form.
  • onboardingRequestError — an error related to the onboarding request, due to a configuration issue other than onboarding token. Contact [email protected] for help if you hit this.
  • onboardingInternalError — the customer's utility connection failed in a way that's not immediately retryable, for example if the utility portal is down temporarily.

If you don't use the Bayou embed library, the corresponding events arebayouOnboardingTokenError, bayouOnboardingRequestError, and bayouOnboardingInternalError.

Bill and Interval Data Improvements

Additional meter attributes

Utility bills often carry identifiers beyond the account number and meter number — for example a utility customer number, a service reference number, a point of delivery (PoD) ID, or (for utilities with retail choice programs) a Choice Service ID. We now parse these identifiers into the additional_attributes object on the meter data model for 15 utilities:

  • customer numbers for the FirstEnergy utilities (JCP&L, The Illuminating Company, Ohio Edison, Toledo Edison, Met-Ed, Penelec, Penn Power, and West Penn Power)
  • service reference numbers for Eversource MA and WMECO, PoD IDs for PSE&G NJ, Central Hudson, and RG&E
  • Choice Service IDs for Duke Energy Ohio and AES Ohio.

These identifiers are frequently required for retail energy and community solar enrollment, so having them parsed directly from the bill removes a manual lookup step. Check out our Utility Specific Notes page for more details.

Parsing and data-quality improvements

We made bill parsing and interval data improvements at 16 utilities this month, including Ameren Illinois, Atlantic City Electric, Central Maine Power, ComEd, Duke Energy, Duquesne Light, El Paso Electric, Eversource, National Grid NY, Orange & Rockland, PECO, Pepco, PG&E, Portland General Electric, Rhode Island Energy, and Xcel Energy.

The changes include support for redesigned bill layouts and new tariff types, more reliable identification of meters and service numbers on multi-meter and dual-fuel accounts, expanded parsing of solar and community solar bills, and more.

Utility Website Updates

We continue to adapt as utilities update their portals, login systems, and security measures. Some changes we handled this month:

  • Central Maine Power moved its login to the shared Avangrid portal
  • Florida Power & Light changed to a new login endpoint
  • Exelon utilities (ComEd, PECO, BGE, Pepco, Delmarva, Atlantic City Electric) rolled out changes to their MFA flow
  • Central Hudson made changes to their sign-in process
  • Dominion Energy Virginia made changes to their sign-in process