Utility Website Updates: Made updates to adapt to significant changes on five utility websites, including a complete overhaul of Duke Energy’s portal and Multi-Factor Authentication (MFA) changes at three utilities.
General Improvements: Increased authentication speed, reliability, and bill parsing quality across several utilities. A highlight here is that we can now authenticate customers of First Energy utilities in under 20 seconds with 88% reliability.
Check out our utility support page for detailed info on our coverage and reliability.
Utility Website Updates
Utilities are constantly updating their portals, so maintaining reliable utility data requires updates on our end to adapt. Here are the most significant utility changes in November:
Duke Energy completely redesigned their portal and their Multi-Factor Authentication (MFA) flow.
PSE&G New Jersey changed their MFA flow and started prompting customers to set up additional MFA methods
PECO added a new pop-up to push customers to enable MFA
AES Ohio changed an authentication redirect
DTE Energy added a captcha requirement during authentication
Maintaining solid MFA support is important as MFA now affects over 41% of US meters, and more utilities have been pushing their customers towards MFA (or requiring it) this year. Read more about How MFA/2FA Impacts Utility API Access on our blog.
General Improvements
In addition to handling utility website changes, we’ve been improving our system to broaden utility support and increase reliability and speed. Here are some highlights of what we’ve shipped in November:
Improved authentication speed and reliability for PPL, Rhode Island Energy, and our seven supported First Energy utilities. These utilities present authentication challenges including captcha and other factors. We now authenticate in under 20 seconds, with 85% reliability for PPL and Rhode Island Energy and 88% for First Energy utilities.
Improved bill parsing quality across multiple utilities including Georgia Power, DTE Energy, Dominion Energy Virginia, PECO, Evergy, and more
Added support for interval data on business accounts within ComEd
Fixed intermittent authentication failures at AES Ohio caused by the utility returning server errors after successful authentication
Fixed issue where multiple accounts for the same customer led to duplicate bills
Fixed bill parsing issue for Central Maine Power customers who have solar generation
Expanded Utility Support to 66% of US meters by adding Atlantic City Electric, AES Ohio, Ohio Edison, The Illuminating Company, Metropolitan Edison, Rhode Island Energy, Penn Power, Toledo Edison and West Penn Power
Utility Support & Performance Data: Detailed metrics for every utility - data availability, Multi-Factor Authentication (MFA/2FA) prevalence and speed / success rates for authentication, bill and interval meter data delivery are now available on Bayou's new utility support page.
Customer Status Visibility: Real-time connection health and resolution steps when issues occur
Enhanced Dashboard & Excel Data Availability: Better customer management and additional utility bill /interval meter data available for excel export
Expanded Utility Support
Bayou now has instant support for utilities covering 66% of the US population.
New instant utilities that have been added since June 2025 are:
Atlantic City Electric
AES Ohio
Ohio Edison
The Illuminating Company
Metropolitan Edison
Rhode Island Energy
Penn Power
Toledo Edison
West Penn Power
Utility Support & Performance Data
Detailed metrics for every utility - data availability, Multi-Factor Authentication (MFA/2FA) prevalence and speed / success rates for authentication, bill and interval data delivery are now available on Bayou's new utility support page.
Utility Support Roadmap
Our public goal at Bayou is to support 78% of US meters as soon as possible. 78% represents all the large utilities in the US and the remaining 22% is covered by the remaining thousands of long tail utilities.
Performance Metrics:
Questions We Constantly Hear when talking to companies at Bayou:
Which utilities have interval meter data? What granularity? (15-minute at PG&E and SCE, 30-minute at ComEd, hourly at FPL, none at Eversource)
Which utilities require MFA? What's the prevalence? (Mandatory at PG&E and Con Edison, 43% of ComEd customers, 54% at Atlantic City Electric)
What's your authentication success rate by utility? (ComEd: 99.9%, PG&E: 82.1%, PPL: 75%)
Are all utilities fast? How does speed vary? (Authentication: SCE 0.7s vs PPL 65s. Bill delivery: 5s vs 120s. Interval delivery: 9s vs 235s)
Which are the largest utilities by meter count? (Duke: 8.5M, Smart Meter Texas: 8.2M, FPL: 6.0M)
Companies would ask us these questions in sales calls, support tickets, or during technical evaluations. We'd answer case-by-case, but you couldn't explore the data yourself or use it to inform launch planning.
Granularity available: 15-minute, 30-minute, hourly, or N/A
Total Meters
Number of meters served by this utility
Overall Success Rate
% of end-to-end data retrieval attempts that succeed
Auth Success Rate
% of credential authentications that succeed (ranges from 56.93% to 99.99%)
Auth Median Time (s)
How long credential validation takes (ranges from 0.6s to 65s)
% Customers with MFA
MFA prevalence: none, percentage (5%-100%), or mandatory
Bill Success Rate
% of bill fetching attempts that succeed (ranges from 85.6% to 99.9%)
Bill Delivery Median Time (s)
Time to return all bill data after authentication (ranges from 5s to 120s)
Intervals Success Rate
% of interval fetching attempts that succeed (ranges from 81.8% to 99.8%)
Interval Delivery Median Time (s)
Time to return all interval data, or "Utility doesn't have intervals" (ranges from 9s to 235s)
Customer Status Visibility
Bayou logs every interaction we make with utility websites. When there's an issue getting customer data, you now see the status in your dashboard with clear direction on what needs to happen - either by you and your customer, or by Bayou.
Context
Bayou is the fastest and most reliable utility data API "but" because we're interacting with utility websites that change without notice, have CAPTCHA challenges, and enforce varying MFA requirements, our overall success rate won't be 100%.
When customer data wasn't loading, companies faced two scenarios:
Individual customer issues: A customer's data shows "Success!" but nothing appears. The company doesn't know if it's invalid credentials, incomplete MFA, a Bayou issue, or utility downtime. They ping Bayou support on Slack or email, we investigate, and everyone waits.
Bulk investigation requests: During a large integration rollout, a company asked Bayou to investigate a batch of customers that hadn't loaded data yet. Our engineering team manually categorized each one: which customers never submitted credentials, which had incomplete MFA, which hit authentication issues we were fixing. This manual categorization work—while thorough—took time.
Both scenarios lacked visibility into who needed to act.
Previous companies using Bayou would troubleshoot by pinging Bayou support (slack, text, email) and manually investigate by checking API responses and searching through logs.
Real-time connection health and resolution steps when issues occur
Every customer in your Bayou dashboard now shows their connection status. When issues occur, you immediately see what's broken, who needs to act, and what action to take.
Status
What It Means
Your Action
Healthy
Customer is authenticated and data is flowing normally.
No action required
Auth: Credentials needed
Customer needs to submit credentials for authentication.
Ask customer to submit credentials and complete MFA if applicable
Auth: MFA needed
Customer needs to complete MFA for authentication.
Ask customer to complete MFA
Auth: Customer must re-authenticate
Customer's previous credentials are invalid or their MFA session expired.
Ask customer to re-authenticate with correct credentials and complete MFA if applicable
Auth issue
Bayou encountered an unexpected issue while attempting to authenticate the customer's utility portal account.
No action required. Bayou is investigating. If urgent, reach out to [email protected]
Bill fetching issue
Bayou encountered an issue while fetching bills from the customer's utility portal.
No action required. Bayou is investigating. If urgent, reach out to [email protected]
Bill parsing issue
Bayou successfully fetched the customer's bills from the utility portal, but we were unable to parse the data from some of the bills.
No action required. Bayou is investigating. If urgent, reach out to [email protected]
Interval fetch issue
Bayou encountered an issue while fetching intervals from the customer's utility portal.
No action required. Bayou is investigating. If urgent, reach out to [email protected]
No data loaded
Bayou encountered an issue attempting to fetch this customer's data from the customer's utility portal.
No action required. Bayou is investigating. If urgent, reach out to [email protected]
📘
A customer displays one prioritized status at a time (most urgent first)
Yellow (Auth …) statuses indicate customer action needed to complete or update authentication.
Red (non‑auth) statuses indicate data issues from the latest run; no customer action unless the message says otherwise.
Hover over the status badge to see the exact status details for a customer
Enhanced Dashboard & Excel Data Availability
Better customer management and additional bill/interval data available for excel export
Manage Large Customer Volumes
The customer dashboard now includes enhanced tools for managing hundreds or thousands of customers:
Enhanced customer table with new columns: Customer ID, External ID (your unique identifier), Email, Utility, Account Numbers, and Status
Pagination for easier navigation across customer lists
Search by Bayou Customer ID, External ID, or Email
Filter by Utility and Customer Status
More Data in Excel Exports
Customer tab: Now includes External ID for linking to your systems
Full customer and connection status information
Instant Utility Support: Launched instant, reliable support for Penelec and Southern California Gas
Building on Bayou with LLMs: All Bayou docs are now available in markdown, making them easy for AI to read
Interval Meter Data Updates:
Interval Granularities Exposed Directly On Meter Objects
Data Automatically Sorted By Timestamp
Duplicate Interval Data Management
New /utilities Endpoint: API endpoint exposing utility support details, availability, and performance
Instant Utility Support
Bayou now has instant customer account authentication, utility bill data and interval meter data delivery within 60 seconds or less for utilities covering 62% of the US population.
New instant utilities that have been added since April 2025 are:
You can use large language models (LLMs) to assist in the building of Bayou Energy integrations, starting with all docs being available in plain text markdown files. To view any page in markdown, simply put a .md at the end of the link. For more details visit our Building on Bayou with LLMs page and for an example view this page in markdown here: https://docs.bayou.energy/changelog/bayou-may-2025-utility-api-update.md
Interval Meter Data Updates
Interval Granularities Exposed Directly On Meter Objects
Previously interval granularities were only available across all meters, not broken out meter by meter
Duplicate Interval Data Management
Same period readings for
electricity_consumption,
net_electricity_consumption,
generated_electricity,
electricity_demand, and
gas_consumption are merged into one interval object.
If two duplicate intervals have a zero or null and a non-zero/null value, we keep the non-zero value.
When two non-zero values conflict, we return both in an array so you can resolve downstream in your data pipeline using the
created_at and
updated_at timestamps.
Data Automatically Sorted By Timestamp
Data is sorted bystart, then created_at, then updated_at
Today the /utilities endpoint shows high level utility information, Bayou's support for all utilities and speed for authentication, bills and intervals. Check out the API reference here: https://docs.bayou.energy/reference/get_utilities
Instant utility support: Bayou now has instant customer account authentication, utility bill data and interval meter data delivery within 60 seconds or less for utilities covering 62% of the US population.
Developer Experience - Added Query Parameters to Get Utility Bill Data API Call: Retrieved bills can now be filtered and are sorted according to their billed on date
Developer Experience - New Javascript events for Bayou’s embedded component: Developers using Bayou can now increase customer form conversion by controlling their user experience with the new customerEnteredInvalidCredentials and customerEnteredInvalidMFAChallenge events
Instant utility support
Bayou now has instant customer account authentication, utility bill data and interval meter data delivery within 60 seconds or less for utilities covering 62% of the US population.
New instant utilities that have been added since July 2024 are:
New Javascript events for Bayou’s embedded component
Developers using Bayou can now increase customer form conversion by controlling their user experience with the new customerEnteredInvalidCredentials and customerEnteredInvalidMFAChallenge events
Instant utility support: Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 56% of the US population.
More testing scenarios for Speculoos Power (Bayou’s fake utility: New test credentials cover multi-account, electric and gas only customer scenarios
Instant utility support
Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 56% of the US population.
New instant utilities that have been added this month are:
Avista
Georgia Power
Madison Gas & Electric
Rocky Mountain Power
More testing scenarios for Speculoos Power (Bayou’s fake utility)
Instant utility support: Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 52% of the US population.
Updates to the API call - Get multiple bills for a specific customer: Retrieved bills can now be filtered and are sorted according to their billed on date.
Instant utility support
Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 52% of the US population.
New instant utilities that have been added this month are:
Arizona Public Service
Delmarva Power
DTE Energy
Kentucky Utilities
Pacific Power
San Diego Gas and Electric
Updates to the API call - Get multiple bills for a specific customer
Returned bills are now sorted by their billed_on date (most recent first and oldest last)
Filtering with Query parameters
Retrieved bills can now be filtered by account_number, meter_id, limit (quantity of bills returned), and the start date and end date of the bill's billed_on date.
Errors
New errors have also been added to the API to handle potential scenarios around using the query parameters.
Instant utility support: Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 48% of the US population
Address data: Each meter's physical address is now available in a common data model across all utilities
Tariff data [early access]: Each meter's utility tariff is provided along with contextual information required to use Bayou alongside a tariff database product
Instant utility support
Bayou now authenticates accounts in one second and returns data within 60 seconds or less for utilities covering 48% of the US population.
New instant utilities that have been added since March 1st, 2024 are:
line_2: The second line of the street address for this meter (example: Apt 1, Unit A, Suite 100)
city
state: two letter abbreviation for the state (example: NY)
postal_code: the postal code or zip code (within the US) for the meter
postal_code_suffix: suffix after the postal code (example: in 10001-1234, 1234 is the suffix)
country
The address object is provided within the data model for the
bill
and
customer
endpoints and within the
bills_ready
and
new_bill
webhooks.
Tariff data [early access]:
Each meter's utility tariff is provided along with contextual information required to use Bayou alongside a tariff database product. The tariff object is provided within
the customers data model
within each meter of the customer record's hierarchy.
Each Bayou customer records corresponds to one set of customer utility login credentials. Once a customer connects their account, Bayou creates a hierarchy of each of the customer's account numbers and each meter within each account number.
For each meter the tariff data is within the "tariffs" object.
Here each tariff is shown with:
period_from and period_to: billing dates that meter was enrolled in the tariff
tariff.name: name of the tariff from the customer's utility bill
tariff.code: tariff code assigned by the utility to that tariff. While this isn't always provided by the utility, codes are common.
tariff.mapping: Contextual information required to map the customer's unique tariff to a tariff database product.
For each meter, its entire tariff history is provided.
To start, this is available for Southern California Edison bridging to WattBuy’s tariff API and will be extended to all Bayou’s instant utilities bridging to additional tariff products based on demand.
Schedule a call or
email us
