Skip to main content

POST /traditional-transfer-of-reads/v1/{mpid}/disputes/new

Raises a new transfer-of-reads dispute.

Request​

Method and path:

  • POST /traditional-transfer-of-reads/v1/{mpid}/disputes/new

Headers:

  • X-API-KEY (required): string, API key in UUID format.
  • X-IDEMPOTENCY-KEY (required): string.

Path parameters:

  • mpid (required): string supplier MPID.

Body schema:

  • TraditionalTransferOfReadsDisputeRequestSchema
{
  "mpan_core": 1234567890123,
  "request_id": "72f30f06-afcc-4ad8-8c1f-78e556ea9cbc",
  "dispute_type": "D",
  "additional_information": "Opening read should be amended",
  "meters": [
    {
      "meter_id": "A123456789",
      "registers": [
        {
          "meter_register_id": "01",
          "disputed_reading_value": 100190092.5,
          "proposed_reading_type": "W",
          "proposed_reading_value": "100190090.0",
          "proposal_status": null
        }
      ]
    }
  ]
}

Response​

Success:

  • 202 Accepted
  • Body type: object containing generated dispute metadata
{
  "dispute_id": "62d87bd2-e2d5-4c24-8b32-b1812ef0a95a",
  "dispute_request_datetime": "2026-03-11T14:04:22+00:00"
}

Note:

  • If id is omitted from the request body, the service generates one before responding.

Field-level constraints: