v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
BMRS Datasets

Physical Notifications (PN)

This endpoint provides Physical Notification data received from NGESO. It returns the data valid for a single settlement period. 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 must be specified as a date and settlement period. The date should be provided in the format yyyy-MM-dd.

get/datasets/PN

Query parameters

settlementDatestring date required
Example:2022-07-01

The settlement date to query. This must be in the format yyyy-MM-dd.

settlementPeriodinteger required
Example:5

The settlement period to query. This should be an integer from 1-50 inclusive.

bmUnitstring[]

The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.

[
  "T_ABRBO-1"
]
format'json' | 'xml' | 'csv'

Response data format. Use json/xml to include metadata.

Response

Data retrieved

Example response

{
  "data": [
    {
      "dataset": "PN",
      "settlementDate": "2022-07-01",
      "settlementPeriod": 3,
      "timeFrom": "2022-07-01T13:34:00Z",
      "timeTo": "2022-07-01T13:34:00Z",
      "levelFrom": 5,
      "levelTo": 46,
      "nationalGridBmUnit": "ABRBO-1",
      "bmUnit": "T_ABRBO-1"
    }
  ]
}