Work with energy plans and product reference data

The energy plans endpoints give you access to product reference data — the plans and tariffs institutions offer publicly in the market. In Australia (CDR), this data comes from each energy retailer's public product endpoints, so no consumer consent is required to retrieve it.

What product reference data includes

• Plan name and description
• Fuel type (electricity, gas, or dual fuel)
• Tariff structure (flat rate, time of use, block, controlled load)
• Rates and prices
• Contract terms and exit fees
• Eligibility criteria
• Green energy offerings
• Feed-in tariff rates for solar plans

This data is useful for building plan comparison tools, showing a user their current plan alongside market alternatives, or analysing pricing trends.

Fetching plans

1. List plans with GET /v1/energy/plans. You can filter by institution, fuel type, and other attributes; results are paginated.
2. Fetch a specific plan with GET /v1/energy/plans/{plan_id}.

See the API reference for parameters and the full plan schema.

Plan data quality

Product reference data quality varies significantly by institution. Common issues:

• Missing fields. Some institutions don't populate every field in the schema — for example, eligibility detail may be absent, or a plan's end date may be null even when the plan has a known end date.
• Stale data. Institutions are expected to update their product data when it changes, but some update infrequently, so plans in the API may lag current pricing.
• Empty eligibility. The eligibility fields describe who can access a plan; some institutions leave them empty even when restrictions apply.

Plans vs account plans

Product reference data shows publicly available plans. The plan data on a specific consumer's account (returned by GET /v1/energy/accounts) reflects the plan that consumer is actually enrolled on — including any negotiated rates that differ from the public offer.

For comparison features, match the consumer's account plan against product reference data using the plan identifier returned in both responses.