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

# Consumption By Location

`GET /api/v2/PowerSystem/Consumptions/ByLocations`

Returns a list of consumptions for a date and a list of locations.
            
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. 
            
### 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
- **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 date 2025-05-05](https://proddataservicespublic.blob.core.windows.net/public-api-response-samples/PowerSystem/get_api_v2_PowerSystem_Consumptions_ByLocations.json)

## Query parameters

- `locations` string, required
- `date` string, date, required

## Response `200`

OK

- ApiConsumptionByLocation[]
  - `deliveryDateCET` string, date
  - `updatedAt` string, date-time
  - `unit` string, nullable
  - `status` 'Missing' | 'Available'
  - `location` string, nullable, required
  - `locationType` 'Country' | 'Region'
  - `deliveryAreas` 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)