v1

latestOpenAPI 3.1.02026-07-2694207444.7 KB
PowerSystem

Yearly Consumption

Returns a list of consumptions for a year and one area.

Consumption tells how much electricity is being consumed / used in an area and delivery period.

This corresponds to the "Total Load / Actual" data type in the Entso-e Transparency Platform.

This yearly summary is updated in a rolling manner, and is updated daily.

Response field descriptions

  • yearlySummary: total MWh consumption for the year
  • monthlySummaries: a list of monthly consumption values
    • deliveryDateStartCET: the earliest date taken into account in this monthly summary
    • deliveryDateEndCET: the latest date taken into account in this monthly summary
    • totalVolume: total consumption volume in MWh for the month
  • dailySummaries: a list of daily consumption values
    • deliveryDateCET: the CET delivery date for this summary
    • totalVolume: total consumption volume in MWh for the day
  • consumptions: a list of delivery periods
    • deliveryStart: start of delivery period
    • deliveryEnd: end of delivery period
    • volume: the volume consumed in the delivery period, in MW

Data source: Entso-e Transparency platform. Update frequency and data availability depends on data being reported to Entso-e.

Sample response with valid data for area NO2 and year 2021

get/api/v2/PowerSystem/Consumptions/Yearly/ByArea

Query parameters

areastring required

One area. For example NO1. Supported: 50HZ, AMP, AT, BE, DE-LU, LU, DK1, DK2, EE, FI, FR, LT, LV, NL, NO1, NO2, NO3, NO4, NO5, PL, SE1, SE2, SE3, SE4, TBW, TTG, TEL, BG

yearinteger required

Year in CET (format: yyyy, e.g., 2024)

Response

OK

yearinteger
status'Missing' | 'Available'
updatedAtstring date-time
unitstring nullable
totalVolumeUnitstring nullable
yearlySummarynumber double nullable
deliveryAreastring nullable