ELelexon
SAA Market Reports

Party Imbalanced Position Period (PIPP)

Changed on

This endpoint retrieves the Party Imbalanced Position Period (PIPP) market report, also known as MR1B. It is produced by I014 market report extraction using two files, BMULD and SPPALD.

Results can be filtered by start date, end date, settlement period from, settlement period to, settlement run type, & BSC party ID.

If a BSC Party ID is provided, the allowed time range is limited to 1 year. If a BSC Party ID has not been provided (and so all parties are returned), the allowed time range is limited to 1 day.

get/market-reports/party-imbalanced-position-period

Request

  • Base URL
    https://data.elexon.co.uk/bmrs/api/v1
  • Auth
    none declared

Query parameters

startDatestring date required
Example:2026-08-04

The start of the settlement date range to filter (inclusive).

endDatestring date required
Example:2026-08-04

The end of the settlement date range to filter (inclusive).

settlementPeriodFrominteger
Example:1

The "from" settlement period for the filter, applied to the start date. This should be an integer from 1-50 inclusive.

settlementPeriodTointeger
Example:2

The "to" settlement period for the filter, applied to the end date. This should be an integer from 1-50 inclusive.

settlementRunType'II' | 'SF' | 'R1' | 'R2' | 'R3' | 'RF' | 'DF'
Example:SF

The settlement run type to filter. If omitted, the best available run type is returned for each settlement period based on the priority order: II < SF < R1 < R2 < R3 < RF < DF.

bscPartyIdstring
Example:11XEZPAG

The BSC party ID to filter. If omitted, all available parties are returned, and the date range is limited to a shorter period than when a BSC party ID is supplied.

format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "settlementDate": "2026-09-01",
      "settlementPeriod": 22,
      "settlementRunType": "SF",
      "bscPartyId": "11ABZPAG"
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}

Changes