Skip to main content
GET
List Aggregate Allocations

Authorizations

Authorization
string
header
required

Query Parameters

isp_from
string<date-time>
required

Inclusive lower bound on the settlement period start (RFC 3339).

isp_until
string<date-time>
required

Exclusive upper bound on the settlement period start (RFC 3339).

area
string[] | null

Areas to read, each one as kind:code, where kind is one of metering_grid_area, control_area or scheduling_area, for example scheduling_area:10YDE-RWENET---I. Omit this parameter to read every area.

Maximum array length: 500
flow_direction
enum<string>[] | null

Flow directions to read. Omit to read both.

Available options:
consumption,
production
balance_group
string[] | null

Balance groups to read. Omit to read every group.

Maximum array length: 500
supplier
string[] | null

Suppliers to read. Omit to read every supplier.

Maximum array length: 500
aggregator
enum<string>[] | null

Aggregator roles to read. Omit to read every role.

Available aggregator roles

  • grid_operator — Indicates the source of the aggregation is a grid operator.

  • transmission_operator — Indicates the source of the aggregation is a transmission system operator.

Available options:
grid_operator,
transmission_operator
allocation_basis
enum<string>[] | null

Allocation bases to read. Omit to read every basis.

The basis tells you where the energy data for an aggregation is coming from: Is it directly metered values from smart meters, or is it something calculated from some standard profile?

Available allocation basises

  • metered — Indicates this aggregation's data comes from directly metered energy, like from smart meters.

  • profiled — Indicates this aggregation's data is coming from a 'profile' of some kind, a pre-determined shape of consumption or production, usually coupled with some adjustment calculations, like adjusting for daily temperature or past annual metered consumption.

Available options:
metered,
profiled
market_dimension
string[] | null

Market-specific dimensions to filter by, for markets where there are multiple separate aggregates that share the same common dimensions. Give each one as key:value, for example profile_scheme:sls.

Maximum array length: 500

Response

Successful Response

values
AggregateAllocationRecord · object[]
required