Overview

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:

AES Indiana
Austin Utilities
Citizens Energy
El Paso Electric
Florida Power and Light
Jersey Central Power and Light
LADWPD
NYSEG
PECO
PEPCO
Portland General Electric
PSEG New Jersey
Public Service Company of New Mexico (PNM)
Sacramento Municipal Utility District
Southern California Edison

View full utility support here

Address data

Each meter's physical address is now available in a common data model across all utilities

"address": {
        "line_1": "123 Main St",
        "line_2": "Apt 1",
        "city": "New York",
        "state": "NY",
        "postal_code": 10001,
        "postal_code_suffix": 1234,
        "country": "US"
      }

line_1: The full street address for this meter
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.

{
    "id": 12345,
    "external_id": null,
    "email": "[email protected]",
    "first_name": null,
    "last_name": null,
    "phone_number": null,
    "address_line_1": null,
    "address_line_2": null,
    "city": null,
    "state": null,
    "zipcode": null,
    "utility": "southern_california_edison",
    "onboarding_link": "https://staging.bayou.energy/companies/9/onboard/007237ca2541bd63polmn214db25a50ce384a390b250po037e0c2045ea3c536d_1716510848_40394f8eop27b8db0f672d403e52efc8fc811ecdb2b402a1dfc00ec140c30faa3",
    "onboarding_token": "007237ca2541bd63polmn214db25a50ce384a390b250po037e0c2045ea3c536d_1716510848_40394f8eop27b8db0f672d403e52efc8fc811ecdb2b402a1dfc00ec140c30faa3",
    "tags": [],
    "has_accepted_terms_on": "2024-05-14T00:26:44Z",
    "has_filled_credentials": true,
    "bills_are_ready": true,
    "utility_has_intervals": true,
    "account_has_intervals": true,
    "intervals_are_ready": true,
    "first_interval_discovered": "2023-04-13T07:00:00Z",
    "last_interval_discovered": "2024-05-13T06:45:00Z",
    "account_numbers": [
        {
            "id": "700000976593",
            "meters": [
                {
                    "id": "409833-123086",
                    "type": "electric",
                    "address": {
                        "line_1": "103 Pacific Coast Hwy",
                        "line_2": "Apt 1",
                        "city": "Huntington Beach",
                        "state": "CA",
                        "postal_code": 92648,
                        "postal_code_suffix": 4305,
                        "country": "US"
                      },
                    "tariffs": [
                        {
                            "period_from": "2021-06-11",
                            "period_to": "2023-07-12",
                            "name": "DOMESTIC",
                            "code": "D",
                            "mapping": {
                                 "wattbuy": {
                                         "utility_id": "17609",
                                         "tariff_id": "6618467c49adafec1c02fa92",
                                         "baseline_territory": null
                                }  
                            }
                        },
                        {
                            "period_from": "2023-07-12",
                            "period_to": "2024-05-13",
                            "name": "TOUD-5-8PM (SCE)",
                            "code": "TOU-D-5-8PM",
                            "mapping": {
                                 "wattbuy": {
                                         "utility_id": "17609",
                                         "tariff_id": "64ac3fff756f4c58c25835e7",
                                         "baseline_territory": null
                                }  
                            }
                        }
                    ],
                    "tags": []
                }
            ]
        }
    ]
}

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