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

# Auction Flows

`GET /api/v2/Auction/Flows/ByAreas`

Returns a list of auction flows per area for a market, date and list of areas.
            
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
- **status**: Missing if data does not exist. Preliminary if the market coupling session is not complete. Final once the market coupling session is complete. Cancelled if the auction is cancelled.
- **dailyTotalImport**: total MWh imported volume
- **dailyTotalExport**: total MWh exported volume
- **dailyTotalNetPosition**: total net position in MWh (total import - total export).
            
**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
- `areas` string, required
- `date` string, date, required

## Response `200`

OK

- ApiFlow[]
  - `deliveryDateCET` string, date
  - `updatedAt` string, date-time
  - `deliveryArea` string, nullable, required
  - `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3'
  - `status` 'Missing' | 'Preliminary' | 'Final' | 'Cancelled'
  - `unit` string, nullable
  - `dailyTotalUnit` string, nullable
  - `dailyTotalImport` number, double, nullable
  - `dailyTotalExport` number, double, nullable
  - `dailyTotalNetPosition` number, double, nullable
  - `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/revisions/6a21504d677e/schema)