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

# Physical Notifications (PN) stream

`GET /datasets/PN/stream`

This endpoint provides Physical Notification data received from NGESO.
A Physical Notification is the best estimate of the level of generation or demand that a participant in the BM expects a BM Unit to export or import, respectively, in a Settlement Period.
            
Physical Notifications are submitted as a series of point MW values.
            
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/PN/stream?from=2022-07-01T00:00Z&to=2022-07-03T06:00Z
            
Filtering from settlement datetime to settlement date and period:
            
     /datasets/PN/stream?from=2022-07-01T00:00Z&to=2022-07-03&settlementPeriodTo=15
            
Filtering from settlement date and period to settlement datetime:
            
     /datasets/PN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03T06:00Z
            
Filtering from settlement date and period to settlement date and period:
            
    /datasets/PN/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 PN 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)