Skip to main content

GET /traditional-transfer-of-reads/v1/{mpid}/losing-supplier

Returns pending transfer-of-reads validations for the losing supplier.

Request​

Method and path:

  • GET /traditional-transfer-of-reads/v1/{mpid}/losing-supplier

Headers:

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

Path parameters:

  • mpid (required): string supplier MPID.

Query parameters:

  • mpan_id (optional): integer or string MPAN core filter.
  • start_date (optional): parseable date or datetime string. If only a date is given, time defaults to 00:00:00.
  • end_date (optional): parseable date or datetime string. If only a date is given, time defaults to 23:59:59.

Request body:

  • None.

Response​

Success:

  • 200 OK
  • Body type: TraditionalTransferOfReadsResponseSchema[]
[
  {
    "mpan_core": 1234567890123,
    "request_id": "72f30f06-afcc-4ad8-8c1f-78e556ea9cbc",
    "bsc_validation": "V",
    "site_visit_information": [
      {
        "site_visit_check_code": "01",
        "additional_information": "Customer own reading"
      }
    ],
    "meter_readings": [
      {
        "meter_id": "A123456789",
        "reading_type": "C",
        "meter_reading_flag": true,
        "register_readings": [
          {
            "meter_register_id": "01",
            "reading_datetime": "2024-12-17T09:35:00.540Z",
            "reading": "100190092.5",
            "reading_method": "N"
          }
        ]
      }
    ],
    "request_received_datetime": "2026-03-11T14:04:22+00:00"
  }
]

No content case:

  • 204 No Content when no pending requests match the filters.

Bad request case:

  • 400 when start_date or end_date cannot be parsed.

Field-level constraints: