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

# Consumption

`GET /api/v2/PowerSystem/Consumptions/ByAreas`

Returns a list of consumptions for a date and a list of areas.
            
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.
            
### Response field descriptions
- **status**: Missing if no data found for the date and area. Available if data is present
- **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 areas NO2,NO3 and date 2025-05-05](https://proddataservicespublic.blob.core.windows.net/public-api-response-samples/PowerSystem/get_api_v2_PowerSystem_Consumptions_ByAreas.json)

## Query parameters

- `areas` string, required
- `date` string, date, required

## Response `200`

OK

- ApiConsumption[]
  - `deliveryDateCET` string, date
  - `updatedAt` string, date-time
  - `deliveryArea` string, nullable, required
  - `status` 'Missing' | 'Available'
  - `unit` string, nullable
  - `consumptions` ConsumptionEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `volume` number, double, 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)