---
title: "Party Imbalanced Position Period (PIPP)"
method: GET
path: "/market-reports/party-imbalanced-position-period"
tags: ["SAA Market Reports"]
---

# Party Imbalanced Position Period (PIPP)

`GET /market-reports/party-imbalanced-position-period`

## Request

- Base URL: `https://data.elexon.co.uk/bmrs/api/v1`
- URL: `https://data.elexon.co.uk/bmrs/api/v1/market-reports/party-imbalanced-position-period`
- Auth: none declared

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.

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `settlementPeriodFrom` integer
- `settlementPeriodTo` integer
- `settlementRunType` 'II' | 'SF' | 'R1' | 'R2' | 'R3' | 'RF' | 'DF'
- `bscPartyId` string
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesMarketReportsPartyImbalancedPositionPeriodResponse
  - `data` InsightsApiModelsResponsesMarketReportsPartyImbalancedPositionPeriodResponse[], nullable
    - `settlementDate` string, date: The settlement date.
    - `settlementPeriod` integer: The settlement period.
    - `settlementRunType` string, nullable: The settlement run type.
    - `bscPartyId` string, nullable: The BSC Party ID.
    - `energyImbalanceVolume` number, double, nullable: The energy imbalance volume.
    - `creditedEnergyVolume` number, double, nullable: The credited energy volume.
    - `bmVolume` number, double, nullable: The BM volume.
    - `ecvnVolume` number, double, nullable: The ECVN volume.
    - `mvrnToCreditedEnergy` number, double, nullable: MVRN to credited energy.
    - `mvrnFromCreditedEnergy` number, double, nullable: MVRN from credited energy.
    - `energyImbalanceCashflow` number, double, nullable: The energy imbalance cashflow.
    - `bmUnitCashflow` number, double, nullable: The BM unit cashflow.
    - `informationImbalanceCashflow` number, double, nullable: The information imbalance cashflow.
    - `nonDeliveryCharge` number, double, nullable: The non-delivery charge.
    - `residualCashflowReallocationCharge` number, double, nullable: The residual cashflow reallocation charge.
    - `periodVirtualLeadPartyCompensationCashflow` number, double, nullable: The period virtual lead party compensation cashflow.
    - `periodSupplierCompensationCashflow` number, double, nullable: The period supplier compensation cashflow.
    - `periodPartyDirectCompensationCashflow` number, double, nullable: The period party direct compensation cashflow.
    - `totalCashflow` number, double, nullable: The total cashflow.
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## Other responses

- `400`: Error with query parameters - see response for details
- `429`: Too many requests
- `500`: Server error - please try again later

## Changes

- **2026-11-05** `d992cbaa9351`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elexon/apis/bmrs-insights/changes/market-reports/party-imbalanced-position-period/get.md)

---

[API](https://skmtc.dev/elexon/apis/bmrs-insights.md) - [All operations](https://skmtc.dev/elexon/apis/bmrs-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/elexon/apis/bmrs-insights/revisions/d992cbaa9351?raw)