Data Methodology
Electricity
Bill Hero's electricity dataset covers residential plans across all Australian NEM distribution networks, ingested daily at 6am AEST from the Consumer Data Right (CDR) energy API with AER Default Market Offer and Victorian Default Offer benchmarks applied, producing annual cost estimates at standard household consumption levels.
What this dataset covers
All publicly available residential electricity plans across the National Electricity Market (NEM) distribution networks that retailers are required to publish under the Consumer Data Right (CDR) energy sector rules. This includes single-rate, time-of-use, and demand tariff structures for NSW, VIC, QLD, SA, and ACT.
Business-only plans, tariffs available exclusively through direct sales channels, and plans marked as unavailable to new customers are excluded. Western Australia operates outside the NEM under Synergy and is not included.
Sources
Plan data is ingested from the CDR energy API endpoints that each accredited energy retailer is required to expose under the Consumer Data Standards (CDS). Bill Hero's ingest script polls the CDR Register to discover active retailers, then fetches their plan listings and tariff schedules directly.
AER Default Market Offer (DMO) and Victorian Default Offer (VDO) benchmark rates are loaded separately from AER-published reference data and stored alongside plan records as comparison anchors. These benchmarks are updated when AER publishes new determination figures, typically annually in mid-year.
Tariff network codes are scraped from Energy Made Easy as a supplementary enrichment step. This step is non-blocking; the ingest proceeds even if the EME scrape fails or times out.
Refresh cadence
The full CDR ingest runs daily at 6am AEST (20:00 UTC the prior day). Each run fetches the current plan listing from every active retailer, upserts plan records, and records a price history snapshot. The resulting dataset is propagated to the production database (Turso) within the same workflow run, so the data feed reflects the prior day's state by approximately 7am AEST.
How prices are computed
Annual cost estimates are computed for each plan at a set of standard household consumption levels defined by the AER (e.g., 3,900 kWh/year for a typical NSW household). The computation applies the plan's usage rates and supply charge in sequence, including:
- Flat or tiered usage rates (cents per kWh, GST inclusive)
- Daily supply charge (dollars per day)
- Time-of-use peak/shoulder/off-peak split where applicable
- Demand tariff components where the plan structure includes them
- Controlled load rates for hot water and off-peak circuits, if present
Conditional discounts (pay-on-time, direct debit) are recorded in the dataset but are not applied to the base cost estimate. This matches the AER's methodology for DMO comparisons. Solar feed-in tariff credits are stored as a separate field and not netted against usage cost.
Known limitations
CDR plan data reflects what retailers publish via their API endpoints. Retailers occasionally publish stale or incorrect rate data; Bill Hero does not independently verify individual tariff schedules against physical network tariff codes, except where the EME enrichment step provides a cross-check.
Controlled load eligibility varies by meter type and distributor zone. The dataset records whether a plan includes controlled load rates, but Bill Hero does not model whether any given household's meter supports them.
Sign-up credits and one-off bill credits are recorded but not applied to the annual cost estimate, because they are single-event benefits that distort long-run comparisons.
Verification & corrections
Errors in electricity data can be reported to data@billhero.com.au. Omissions or corrections are typically applied within 48 hours of verification.
Licence & attribution
Published under Creative Commons CC-BY-4.0. Attribution required: "Data via Bill Hero (billhero.com.au)". Commercial republication is permitted with attribution; bulk redistribution is rate-limited at 10 req/s per IP.
Citation format
Bill Hero (2026). Australian Residential Electricity Plans Dataset. https://billhero.com.au/data/electricity. Accessed [date]. CC-BY-4.0.
@misc{billhero2026electricity,
author = {{Bill Hero}},
title = {Australian Residential Electricity Plans Dataset},
year = {2026},
url = {https://billhero.com.au/data/electricity},
note = {Accessed [date]. CC-BY-4.0. Updated daily from CDR energy API.},
}The canonical AI feed lives at /data/electricity. The legacy /data/plans/all endpoint remains available with the same source data.
