Skip to main content

POST /metering-changes/v1/{mpid}

Sends a metering change request to the metering service for one MPAN.

Request​

Method and path:

  • POST /metering-changes/v1/{mpid}

Headers:

  • X-API-KEY (required): string, API key in UUID format.
  • X-IDEMPOTENCY-KEY (required): string.
  • X-TEST-MODE (optional): string, set to true to suppress production communications.

Path parameters:

  • mpid (required): string supplier MPID.

Body schema:

  • MeteringChangesRequestSchema
{
  "mpan_core": 1234567890123,
  "appointment_date": "20270401",
  "earliest_appointment_time": "090000",
  "latest_appointment_time": "120000",
  "requested_energisation_status": "E",
  "additional_information": "Exchange meter and preserve comms hub if possible",
  "remove_all_meters": false,
  "retrieval_method": "M",
  "ssc_id": "0001",
  "metering_system_nsfc": "NSFC001",
  "communications_method": "WAN"
}

Response​

Success:

  • 200 OK
  • Body type: SupplierProcessResponseSchema
{
  "request_id": "72f30f06-afcc-4ad8-8c1f-78e556ea9cbc",
  "request_type": "metering-changes",
  "request_status": "Pending",
  "description": "Metering Changes Process",
  "created_at": "2026-03-11T14:04:22+00:00",
  "last_updated_at": "2026-03-11T14:04:22+00:00",
  "mpan_core": 1234567890123
}

Other documented responses:

  • 401 Unauthorized
  • 422 Validation error
  • 428 Missing X-IDEMPOTENCY-KEY

Field-level constraints: