---
agentTools:
  projectIndex: https://docs.bayou.energy/llms.txt
---

# Bayou Energy October 2025 Utility API Update

# Overview

* **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.

<Image align="center" alt="Bayou Energy's utility API supports getting utility data from 66% of the US population's utility meters" border={true} src="https://files.readme.io/a9ea64cfeb4c96a3cc9fd5bbc06f7188cb3b91cbd84cded9e319c213394ea094-Screenshot_2025-10-14_at_09.12.01.png" className="border" />

New instant utilities that have been added since June 2025 are:

1. Atlantic City Electric
2. AES Ohio
3. Ohio Edison
4. The Illuminating Company
5. Metropolitan Edison
6. Rhode Island Energy
7. Penn Power
8. Toledo Edison
9. 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 <Anchor label="Bayou's new utility support page" target="_blank" href="https://www.bayou.energy/utilities">Bayou's new utility support page</Anchor>.

## 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.

<Image align="center" alt="utility api support roadmap to get customer utility data" border={true} src="https://files.readme.io/d148af172fb0e23f9fe127ac661c8bb8b59c2cc966a35b107f502bda73e1715f-Screenshot_2025-10-14_at_09.20.43.png" className="border" />

<br />

## 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.

Now all this data is public on our <Anchor label="utility support page" target="_blank" href="https://www.bayou.energy/utilities">utility support page</Anchor> and accessible via our `/utilities`<Anchor label="API endpoint" target="_blank" href="https://docs.bayou.energy/reference/get_utilities#/">API endpoint</Anchor>.

### Metadata We're Publishing For Each Utility

<HTMLBlock>{`
 <table style="width: 100%; border-collapse: collapse; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: black;">
    <thead>
      <tr style="background-color: #111B4C; color: white;">
        <th style="padding: 12px 16px; text-align: left; font-weight: 600;">Metric</th>
        <th style="padding: 12px 16px; text-align: left; font-weight: 600;">Definition</th>
      </tr>
    </thead>
    <tbody>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Utility</strong></td>
        <td style="padding: 12px 16px; color: black;">Utility name and service territory</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>API Code</strong></td>
        <td style="padding: 12px 16px; color: black;">Identifier used in Bayou's API</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Support</strong></td>
        <td style="padding: 12px 16px; color: black;">"Instant" (live now) or "Roadmap" (coming soon)</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Interval Meter Data Support</strong></td>
        <td style="padding: 12px 16px; color: black;">Granularity available: 15-minute, 30-minute, hourly, or N/A</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Total Meters</strong></td>
        <td style="padding: 12px 16px; color: black;">Number of meters served by this utility</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Overall Success Rate</strong></td>
        <td style="padding: 12px 16px; color: black;">% of end-to-end data retrieval attempts that succeed</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth Success Rate</strong></td>
        <td style="padding: 12px 16px; color: black;">% of credential authentications that succeed (ranges from 56.93% to 99.99%)</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth Median Time (s)</strong></td>
        <td style="padding: 12px 16px; color: black;">How long credential validation takes (ranges from 0.6s to 65s)</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>% Customers with MFA</strong></td>
        <td style="padding: 12px 16px; color: black;">MFA prevalence: none, percentage (5%-100%), or mandatory</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Bill Success Rate</strong></td>
        <td style="padding: 12px 16px; color: black;">% of bill fetching attempts that succeed (ranges from 85.6% to 99.9%)</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Bill Delivery Median Time (s)</strong></td>
        <td style="padding: 12px 16px; color: black;">Time to return all bill data after authentication (ranges from 5s to 120s)</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Intervals Success Rate</strong></td>
        <td style="padding: 12px 16px; color: black;">% of interval fetching attempts that succeed (ranges from 81.8% to 99.8%)</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Interval Delivery Median Time (s)</strong></td>
        <td style="padding: 12px 16px; color: black;">Time to return all interval data, or "Utility doesn't have intervals" (ranges from 9s to 235s)</td>
      </tr>
    </tbody>
  </table>
`}</HTMLBlock>

# 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:

1. **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.
2. **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.

<br />

<Image align="center" border={true} src="https://files.readme.io/2b5adb559f8886f18dbd990388822811e14f2636f126692558400e042ff6a7ad-bayou_dashboard_gives_customer_status_visibility_from_getting_utility_data.png" className="border" />

<br />

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: black;">
    <thead>
      <tr style="background-color: #111B4C; color: white;">
        <th style="padding: 12px 16px; text-align: left; font-weight: 600;">Status</th>
        <th style="padding: 12px 16px; text-align: left; font-weight: 600;">What It Means</th>
        <th style="padding: 12px 16px; text-align: left; font-weight: 600;">Your Action</th>
      </tr>
    </thead>
    <tbody>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Healthy</strong></td>
        <td style="padding: 12px 16px; color: black;">Customer is authenticated and data is flowing normally.</td>
        <td style="padding: 12px 16px; color: black;">No action required</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth: Credentials needed</strong></td>
        <td style="padding: 12px 16px; color: black;">Customer needs to submit credentials for authentication.</td>
        <td style="padding: 12px 16px; color: black;">Ask customer to submit credentials and complete MFA if applicable</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth: MFA needed</strong></td>
        <td style="padding: 12px 16px; color: black;">Customer needs to complete MFA for authentication.</td>
        <td style="padding: 12px 16px; color: black;">Ask customer to complete MFA</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth: Customer must re-authenticate</strong></td>
        <td style="padding: 12px 16px; color: black;">Customer's previous credentials are invalid or their MFA session expired.</td>
        <td style="padding: 12px 16px; color: black;">Ask customer to re-authenticate with correct credentials and complete MFA if applicable</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Auth issue</strong></td>
        <td style="padding: 12px 16px; color: black;">Bayou encountered an unexpected issue while attempting to authenticate the customer's utility portal account.</td>
        <td style="padding: 12px 16px; color: black;">No action required. Bayou is investigating. If urgent, reach out to hello@bayou.energy</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Bill fetching issue</strong></td>
        <td style="padding: 12px 16px; color: black;">Bayou encountered an issue while fetching bills from the customer's utility portal.</td>
        <td style="padding: 12px 16px; color: black;">No action required. Bayou is investigating. If urgent, reach out to hello@bayou.energy</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Bill parsing issue</strong></td>
        <td style="padding: 12px 16px; color: black;">Bayou successfully fetched the customer's bills from the utility portal, but we were unable to parse the data from some of the bills.</td>
        <td style="padding: 12px 16px; color: black;">No action required. Bayou is investigating. If urgent, reach out to hello@bayou.energy</td>
      </tr>
      <tr style="background-color: white;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>Interval fetch issue</strong></td>
        <td style="padding: 12px 16px; color: black;">Bayou encountered an issue while fetching intervals from the customer's utility portal.</td>
        <td style="padding: 12px 16px; color: black;">No action required. Bayou is investigating. If urgent, reach out to hello@bayou.energy</td>
      </tr>
      <tr style="background-color: #f9fafb;">
        <td style="padding: 12px 16px; font-weight: 500; color: black;"><strong>No data loaded</strong></td>
        <td style="padding: 12px 16px; color: black;">Bayou encountered an issue attempting to fetch this customer's data from the customer's utility portal.</td>
        <td style="padding: 12px 16px; color: black;">No action required. Bayou is investigating. If urgent, reach out to hello@bayou.energy</td>
      </tr>
    </tbody>
  </table>
`}</HTMLBlock>

<br />

<Callout icon="📘" theme="info">
  * 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
</Callout>

<br />

# 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

<br />

<Image align="center" border={true} src="https://files.readme.io/2b5adb559f8886f18dbd990388822811e14f2636f126692558400e042ff6a7ad-bayou_dashboard_gives_customer_status_visibility_from_getting_utility_data.png" className="border" />

<br />

### More Data in Excel Exports

* **Customer tab**: Now includes External ID for linking to your systems
  Full customer and connection status information
* **Bills tab**: <Anchor label="All fields from Bayou's bill data model" target="_blank" href="https://docs.bayou.energy/reference/get_customers-customer-id-bills#/">All fields from Bayou's bill data model</Anchor> (previously only subset)
  Meter addresses and additional attributes for deeper analysis
* **Intervals tab**: <Anchor label="Full interval data export" target="_blank" href="https://docs.bayou.energy/reference/get_customers-customer-id-intervals#/">Full interval data export</Anchor>