---
title: "Yearly Consumption"
method: GET
path: "/api/v2/PowerSystem/Consumptions/Yearly/ByArea"
tags: ["PowerSystem"]
---

# Yearly Consumption

`GET /api/v2/PowerSystem/Consumptions/Yearly/ByArea`

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](https://proddataservicespublic.blob.core.windows.net/public-api-response-samples/PowerSystem/get_api_v2_PowerSystem_Consumptions_Yearly_ByArea.json)

## Query parameters

- `area` string, required
- `year` integer, required

## Response `200`

OK

- ApiYearlyConsumptionByArea
  - `year` integer
  - `status` 'Missing' | 'Available'
  - `updatedAt` string, date-time
  - `unit` string, nullable
  - `totalVolumeUnit` string, nullable
  - `dailySummaries` ConsumptionDailySummary[], nullable
    - `deliveryDateCET` string, date
    - `totalVolume` number, double, nullable
  - `monthlySummaries` ConsumptionMonthlySummary[], nullable
    - `deliveryDateStartCET` string, date
    - `deliveryDateEndCET` string, date
    - `totalVolume` number, double, nullable
  - `yearlySummary` number, double, nullable
  - `consumptions` ConsumptionEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `volume` number, double, nullable
  - `deliveryArea` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/nordpoolgroup/apis/auction-member-test.md) · [All operations](https://skmtc.net/nordpoolgroup/apis/auction-member-test/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nordpoolgroup/auction-member-test/versions/6a21504d677e/schema)