v1

latestOpenAPI 3.1.02026-07-2694207444.7 KB
PowerSystem

Yearly Consumption by Location

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

Consumption tells how much electricity is being consumed / used in an area and delivery period. Consumption by location aggregates delivery area consumption value into country or region values.

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

Response field descriptions

  • status: Missing if no data found for the date and area. Available if data is present
  • locationType: Country or Region
  • deliveryAreas: delivery areas used for this locational aggregation
  • 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 location NO and year 2021

get/api/v2/PowerSystem/Consumptions/Yearly/ByLocation

Query parameters

locationstring required

One location. For example NO. Supported: AT, BE, DE, LU, DK, EE, FI, FR, LT, LV, NL, NO, PL, SE, RO, BG, BALTIC, CWE, DE-LU, NORDIC

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
locationstring nullable required
locationType'Country' | 'Region'
deliveryAreasstring[] nullable