How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AEMO Energy Plans API

Energy Plan endpoints

AEMO Energy Plans API is one of 86 APIs that AEMO publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Energy Plans. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 2 operations across 2 paths, and defines 49 schemas. It is described by OpenAPI 3.2.0, at version 1.36.0.

Requests are made against a single base URL, https://mtls.dh.example.com/cds-au/v1.

2 operations 2 paths 49 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.36.0
Base URL
https://visualisations.aemo.com.au/aemo/apps/api/report
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Energy Plans 2

Energy Plan endpoints

GET
/energy/plans
Get Generic Plans
listEnergyPlans 9 params → 200400406422
GET
/energy/plans/{planId}
Get Generic Plan Detail
getEnergyPlanDetail 3 params → 200400404406

Schemas 49

The contract defines 49 schemas that model the data the API accepts and returns. The most detailed are EnergyPlanContractV3 (16 properties), EnergyPlan (14 properties), EnergyPlanTariffPeriodV2 (12 properties), EnergyPlanTariffPeriodV2_demandCharges (11 properties). Each schema is shown below with its type and property counts.

EnergyPlanResponseV3
object
3 properties 2 required
MeasureUnitEnum
string
EnergyPlanControlledLoadV2
object
6 properties 2 required
EnergyPlanTariffPeriodV2_singleRate
object
Object representing a single rate. Required if rateBlockUType is singleRate.
5 properties 2 required
EnergyPlanGreenPowerCharges
object
5 properties 4 required
EnergyPlan_geography
object
Describes the geographical area that the plan is available for. If absent then it is assumed the plan is not geographically limited.
3 properties 1 required
EnergyPlan_additionalInformation
object
Object that contains links to additional information on specific topics.
5 properties
LinksPaginated
object
5 properties 1 required
Links
object
1 property 1 required
EnergyPlanGreenPowerCharges_tiers
object
3 properties 1 required
EnergyPlanSolarFeedInTariffV3_singleTariff_rates
object
3 properties 1 required
EnergyPlanTariffPeriodV2_bandedDailySupplyCharges
object
3 properties 1 required
EnergyPlanListResponse
object
3 properties 3 required
EnergyPlanDiscounts_percentOfBill
object
Required if methodUType is percentOfBill.
1 property 1 required
EnergyPlanSolarFeedInTariffV3
object
9 properties 4 required
EnergyPlanTariffPeriodV2_demandCharges
object
11 properties 6 required
EnergyPlanId
string
The unique identifier for the Energy plan.
EnergyPlanDiscounts
object
10 properties 3 required
EnergyPlanDiscounts_percentOverThreshold
object
Required if methodUType is percentOverThreshold.
2 properties 2 required
EnergyPlanSolarFeedInTariffV3_timeVaryingTariffs
object
5 properties 2 required
EnergyPlanControlledLoadV2_timeOfUse
object
5 properties
EnergyPlanSolarFeedInTariffV3_singleTariff
object
Represents a constant tariff. Mandatory if tariffUType is set to singleTariff.
2 properties 1 required
EnergyPlanDetailV3
EnergyPlanContractFullV3
EnergyPlanDiscounts_fixedAmount
object
Required if methodUType is fixedAmount.
1 property 1 required
EnergyPlanListResponse_data
object
1 property 1 required
EnergyPlanContractV3_intrinsicGreenPower
object
Describes intrinsic green power for the plan. If present then the plan includes a percentage of green power in the base plan. Should not be present for gas con…
1 property 1 required
EnergyPlanSolarFeedInTariffV3_timeVariations
object
3 properties 1 required
EnergyPlanControlledLoadV2_singleRate
object
Object representing a single controlled load rate. Required if rateBlockUType is singleRate.
5 properties 2 required
EnergyPlanDiscounts_percentOfUse
object
Required if methodUType is percentOfUse.
1 property 1 required
EnergyPlanContractV3
object
16 properties 4 required
ErrorV2_meta
object
Additional data for customised error codes.
1 property
EnergyPlanContractFullV3_allOf
object
6 properties 1 required
EnergyPlan
object
14 properties 6 required
ResponseErrorListV2
object
1 property 1 required
ErrorV2
object
4 properties 3 required
MetaPaginated
object
2 properties 2 required
EnergyDaysEnum
string
EnergyPlanTariffPeriodV2_timeOfUseRates
object
6 properties 4 required
Meta
object
EnergyPlanTariffPeriodV2_timeOfUse
object
3 properties 3 required
EnergyPlanControlledLoadV2_singleRate_rates
object
3 properties 1 required
EnergyPlanIncentives
object
4 properties 3 required
EnergyPlanFees
object
5 properties 2 required
EnergyPlanControlledLoadV2_timeOfUseRates
object
7 properties 4 required
EnergyPlanTariffPeriodV2
object
12 properties 4 required
EnergyPlanDetailV3_allOf
object
3 properties
EnergyPlanDetailV3_allOf_meteringCharges
object
5 properties 2 required
EnergyPlanEligibility
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aemo-energy-plans-api-openapi.yml Raw ↑

Other APIs AEMO publishes across the network.

AEMO NEM Data Dashboard API
AEMO NEMWeb Public Data Feed
AEMO WA Market Data Public Feed
AEMO B2 B Messaging Async API
AEMO B2 B Messaging Pull API
AEMO B2 B Messaging Sync API
AEMO B2 M Messaging Async API
AEMO B2 M Messaging Pull API
AEMO B2 M Messaging Sync API
AEMO Balancing Reports v2.1 API
AEMO Balancing Reports v2.2 API
AEMO Balancing Reports v2.3 API
Where this information came from

This is an independent, third-party profile of AEMO Energy Plans API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.