---
title: "Trading unit data (S0491_TUDM) stream"
method: GET
path: "/datasets/TUDM/stream"
tags: ["BMRS Datasets"]
---

# Trading unit data (S0491_TUDM) stream

`GET /datasets/TUDM/stream`

This endpoint provides trading unit data filtered by settlement period, trading unit name and type.

This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.

## Query parameters

- `settlementDateFrom` string, date, required
- `settlementPeriodFrom` integer, required
- `settlementDateTo` string, date, required
- `settlementPeriodTo` integer, required
- `tradingUnitName` string[]
- `tradingUnitType` 'Base' | 'Sole' | 'Others'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesMiscDatasetRowsTudmDatasetRow[]
  - `dataset` string, nullable
  - `serialNumber` string, nullable
  - `fileCreationTime` string, date-time
  - `tradingUnitType` string, nullable
  - `tradingUnitName` string, nullable
  - `settlementDate` string, date
  - `settlementPeriod` integer
  - `settlementRunType` string, nullable
  - `startTime` string, date-time
  - `deliveryMode` string, nullable
  - `importVolume` number, double
  - `exportVolume` number, double
  - `netVolume` number, double

## Other responses

- `400` — Error with query parameters - see response for details
- `429` — Too many requests
- `500` — Server error - please try again later

---

[API](https://skmtc.net/elexon/apis/bmrs-insights.md) · [All operations](https://skmtc.net/elexon/apis/bmrs-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/bmrs-insights/versions/d94e9edb295e/schema)