---
title: "Hydro Reservoir Reserves"
method: GET
path: "/api/v2/PowerSystem/HydroReservoirReserves/ByAreas"
tags: ["PowerSystem"]
---

# Hydro Reservoir Reserves

`GET /api/v2/PowerSystem/HydroReservoirReserves/ByAreas`

Returns a list of weekly hydro reservoir values for a year and a list of areas.
            
### Response field descriptions
- **hydroReservoirReserves**: a list of weekly reservoir values 
  - **isoWeek**: the ISO week for the year
  - **weekStartDate**: CET start date for the week
  - **weekEndDate**: CET end date for the week
  - **maxCapacityInGigawattHour**: maximum storage capacity for the area (or region)
  - **currentCapacityInGigawattHours**: current weekly capacity
  - **utilizationPercentage**: utilization given in percentage. Equal to ((currentCapacity) / (max Capacity)) * 100 
            
[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_HydroReservoirReserves_ByAreas.json)

## Query parameters

- `areas` string, required
- `year` integer, required

## Response `200`

OK

- ApiHydro[]
  - `year` integer
  - `deliveryArea` string, nullable, required
  - `updatedAt` string, date-time
  - `status` 'Missing' | 'Available'
  - `unit` string, nullable
  - `hydroReservoirReserves` ApiReservoirWeek[], nullable
    - `isoWeek` integer
    - `weekStartDate` string, date
    - `weekEndDate` string, date
    - `maxCapacityInGigawattHours` number, double
    - `currentCapacityInGigawattHours` number, double
    - `utilizationPercentage` number, double

## 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)