Skip to main content

An aggregate allocation and its aggregation dimensions. A null or absent dimension includes the accounting points of all values.

aggregator
enum<string>
required

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
Example:

"grid_operator"

allocation_basis
enum<string>
required

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 bases

  • 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
Example:

"metered"

area_code
string
required
Examples:

"10YDE-RWENET---I"

"871664139537672423"

area_kind
enum<string>
required

Available area kinds

  • metering_grid_area — The area of one grid operator.

  • control_area — The area of one transmission system operator.

  • scheduling_area — See Scheduling Area.

Available options:
metering_grid_area,
control_area,
scheduling_area
Example:

"metering_grid_area"

balance_group
string | null
required

The balance group of the accounting points in the aggregate allocation. If the value is null, the aggregate allocation includes all balance groups.

Example:

"11XBILANZKREIS-X"

external_id
string
required

A stable identifier for the aggregate allocations. In most markets this is a unique identifier assigned by that market, but in markets that don't provide a stable identity (like NL), it's assigned by Engrate

flow_direction
enum<string>
required
Available options:
consumption,
production
market_dimensions
Market Dimensions · object
required

Market-specific additional dimensions, used in markets that sub-divide aggregate allocations beyond what the common dimensions can represent. See Market dimensions and metadata in each market for the keys of each market.

Examples:
market_meta
Market Meta · object
required

Market-specific additional metadata, for instance in markets where datasets with the exact same dimensions are sent at different cadences (daily, monthly), this metadata tells them apart. See Market dimensions and metadata in each market for the keys of each market.

Example:
supplier
string | null
required

The supplier of the accounting points in the aggregate allocation. If the value is null, the aggregate allocation includes all suppliers.

Example:

"9900000000001"