---
title: "Quiescent Physical Notifications (QPN) stream"
method: GET
path: "/datasets/QPN/stream"
tags: ["BMRS Datasets"]
---

# Quiescent Physical Notifications (QPN) stream

`GET /datasets/QPN/stream`

This endpoint provides Quiescent Physical Notification data received from NGESO.
Quiescent Physical Notifications describe the MW levels to be deducted from the Physical Notification of a BM Unit to determine a resultant operating level.
            
The settlement period to query can be specified as a date and settlement period, or as a datetime
which will resolve to the settlement period that time falls within.
If a settlement period is provided, it will take precedence over the time portion of the datetime.

Some examples of date parameter combinations are shown below.
            
Filtering from settlement datetime to settlement datetime:
            
     /datasets/QPN/stream?from=2022-07-01T00:00Z&to=2022-07-03T06:00Z
            
Filtering from settlement datetime to settlement date and period:
            
     /datasets/QPN/stream?from=2022-07-01T00:00Z&to=2022-07-03&settlementPeriodTo=15
            
Filtering from settlement date and period to settlement datetime:
            
     /datasets/QPN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03T06:00Z
            
Filtering from settlement date and period to settlement date and period:
            
    /datasets/QPN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03&settlementPeriodTo=15

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

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `settlementPeriodFrom` integer
- `settlementPeriodTo` integer
- `bmUnit` string[]

## Response `200`

Data retrieved

- InsightsApiModelsResponsesBalancingPhysicalDatasetRowsPhysicalNotificationData[]
  - `dataset` string, nullable
  - `settlementDate` string, date
  - `settlementPeriod` integer
  - `timeFrom` string, date-time
  - `timeTo` string, date-time
  - `levelFrom` integer
  - `levelTo` integer
  - `nationalGridBmUnit` string, nullable
  - `bmUnit` string, nullable

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