ELelexon
SAA Market Reports

Party Imbalanced Position Period (PIPP) stream

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. Provided as a streaming endpoint.

Results can be filtered by from date, to 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 3 years. If a BSC Party ID has not been provided (and so all parties are returned), the allowed time range is limited to 1 week.

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

Request

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

Query parameters

fromDatestring date required
Example:2026-08-04

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

toDatestring 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 from date. This should be an integer from 1-50 inclusive. The filter covers the continuous range from fromDate/settlementPeriodFrom to toDate/settlementPeriodTo. If omitted, the range starts at the beginning of the from date.

settlementPeriodTointeger
Example:2

The "to" settlement period for the filter, applied to the to date. This should be an integer from 1-50 inclusive. The filter covers the continuous range from fromDate/settlementPeriodFrom to toDate/settlementPeriodTo. If omitted, the range runs to the end of the to date.

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 date 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.

Response

Data retrieved

settlementDatestring date

The settlement date.

settlementPeriodinteger

The settlement period.

settlementRunTypestring nullable

The settlement run type.

bscPartyIdstring nullable

The BSC Party ID.

energyImbalanceVolumenumber double nullable

The energy imbalance volume.

creditedEnergyVolumenumber double nullable

The credited energy volume.

bmVolumenumber double nullable

The BM volume.

ecvnVolumenumber double nullable

The ECVN volume.

mvrnToCreditedEnergynumber double nullable

MVRN to credited energy.

mvrnFromCreditedEnergynumber double nullable

MVRN from credited energy.

energyImbalanceCashflownumber double nullable

The energy imbalance cashflow.

bmUnitCashflownumber double nullable

The BM unit cashflow.

informationImbalanceCashflownumber double nullable

The information imbalance cashflow.

nonDeliveryChargenumber double nullable

The non-delivery charge.

residualCashflowReallocationChargenumber double nullable

The residual cashflow reallocation charge.

periodVirtualLeadPartyCompensationCashflownumber double nullable

The period virtual lead party compensation cashflow.

periodSupplierCompensationCashflownumber double nullable

The period supplier compensation cashflow.

periodPartyDirectCompensationCashflownumber double nullable

The period party direct compensation cashflow.

totalCashflownumber double nullable

The total cashflow.

Example response

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

Changes