---
title: "Market-wide dynamic data (SEL, SIL, MZT, MNZT, MDV, MDP, NTB, NTO, NDZ)"
method: GET
path: "/balancing/dynamic/all"
tags: ["Balancing Mechanism Dynamic"]
---

# Market-wide dynamic data (SEL, SIL, MZT, MNZT, MDV, MDP, NTB, NTO, NDZ)

`GET /balancing/dynamic/all`

This endpoint provides the dynamic data for multiple requested BMUs or all BMUs, excluding dynamic rate data.
It returns the data valid for a single settlement period. This includes a snapshot of data valid at the start
of the settlement period, and any changes published during that settlement period.
            
By default, all of the relevant datasets are returned: SIL, SEL, NDZ, NTB, NTO, MZT, MNZT, MDV & MDP.
The results from each dataset are transformed to a common response model, with the common integer field *Value*
mapped from the fields *Level*, *Period*, *Volume* or *Notice* in the original dataset, as relevant.
            
The settlement period must be specified as a date and settlement period. The date parameter must be provided in the exact format yyyy-MM-dd.
            
This endpoint is quota limited.
For individual dynamic datasets, use the relevant /datasets/ endpoints.
For real-time updates as each data point is published, use the Insights IRIS service. You can register for free at  https://bmrs.elexon.co.uk/iris .
For historical data, check out the IRIS archive, which keeps a record of all published datasets.

## Query parameters

- `settlementDate` string, date, required
- `settlementPeriod` integer, required
- `bmUnit` string[]
- `dataset` string[]
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingDynamicDynamicData
  - `data` InsightsApiModelsResponsesBalancingDynamicDynamicData[], nullable
    - `dataset` string, nullable
    - `bmUnit` string, nullable
    - `nationalGridBmUnit` string, nullable
    - `time` string, date-time
    - `value` integer
    - `settlementDate` string, date
    - `settlementPeriod` integer
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## Other responses

- `400` — Error with query parameters - see response for details
- `403` — Quota exceeded - see response for how long to wait before trying again
- `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)
