---
title: "Yearly Auction Flows"
method: GET
path: "/api/v2/Auction/Flows/Yearly/ByArea"
tags: ["Auction"]
---

# Yearly Auction Flows

`GET /api/v2/Auction/Flows/Yearly/ByArea`

Returns a list of auction flows for a market, year and one area.
            
Flows are describing how much power are exchanged in between areas.
            
This is the flow coming from Euphemia - note that in the Nordic region a post coupling calculation is done to adjust this flow. See Scheduled Physical Flows for Nordic Day-ahead flows after 30th of October 2024.
            
Flows are always described from an area point of view. Some flows will have a loss on the cable - imports in an area is always after losses, and exports are before losses.
            
### Response field descriptions
**dailySummaries**: contains a list of daily summaries for all flows for that day
- **totalImport**: total import volume for the day, in MWh
- **totalExport**: total export volume for the day, in MWh
- **totalNetPosition**: total net position for the day (total import - total export), in MWh
- **connectionSummaries**: list of all connections used for the day, with total imports and exports given in MWh 
            
**flows**: a list of delivery periods, containing all flows for that period
- **byConnection**: a list of all connections that has a flow for the period. Each connection is identified by an area and optionally by a connection name. The Connection name is only present if multiple connections exists on the same border. **import** gives the import volume in MW, **export** the export volume in MW and **netPosition** describes import-export
- **totalImport**: sum of all connection import volumes given in MW
- **totalExport**: sum of all connection export volumes given in MW
- **totalNetPosition**: total import - total export

## Query parameters

- `market` 'DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3', required
- `area` string, required
- `year` integer, required

## Response `200`

OK

- ApiAuctionYearlyFlow
  - `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3'
  - `deliveryArea` string, nullable, required
  - `year` integer
  - `status` 'Missing' | 'Preliminary' | 'Final' | 'Cancelled'
  - `updatedAt` string, date-time
  - `dailyTotalUnit` string, nullable
  - `dailySummaries` FlowDailySummary[], nullable
    - `deliveryDateCET` string, date
    - `totalImport` number, double, nullable
    - `totalExport` number, double, nullable
    - `totalNetPosition` number, double, nullable
    - `connectionSummaries` FlowConnectionDailySummary[], nullable
      - `totalImport` number, double, nullable
      - `totalExport` number, double, nullable
      - `totalNetPosition` number, double, nullable
      - `area` string, nullable
      - `connection` string, nullable
  - `unit` string, nullable, required
  - `flows` ApiTransfer[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `byConnections` ApiByConnection[], nullable
      - `area` string, nullable, required
      - `connection` string, nullable
      - `import` number, double, nullable
      - `export` number, double, nullable
      - `netPosition` number, double, nullable
    - `totalImport` number, double, nullable
    - `totalExport` number, double, nullable
    - `totalNetPosition` 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)