POST /readings/v1/{mpid}/send

Sends a new reading for one supplier MPAN and meter.

Request

Method and path:

• POST /readings/v1/{mpid}/send

Headers:

• X-API-KEY (required): string, API key used for tenant authorization.
• X-IDEMPOTENCY-KEY (required): string idempotency key.

Path parameters:

• mpid (required): string supplier MPID.

Body schema:

• SendReadingsSchema

{
  "reading_type": "C",
  "mpan_core": 1234567890123,
  "meter_id": "A1B2C3D4E5",
  "cumulative_reading_datetime": "2026-03-20T08:00:00+00:00",
  "reading_method": "A",
  "cumulative_register_reading": "001234",
  "site_visit_check_code": null,
  "register_readings": [
    {
      "register_id": "01",
      "register_reading": "001234",
      "register_reading_datetime": "2026-03-20T08:00:00+00:00"
    }
  ]
}

Response

Success:

• 201 Created
• Body type: object

{
  "message_id": "b80dd257-5536-4b1c-ae58-1d4314948efb",
  "recipients_dip_id": [
    [
      "DIP-DC-001"
    ]
  ],
  "status": "sent",
  "sent_datetime": "2026-03-20T08:15:04+00:00",
  "mpan_core": 1234567890123
}

Other documented responses:

• 403 when the MPAN is not active for the supplier.
• 404 when the MPAN or meter is not found.
• 409 when the meter group is unsupported for sending readings.
• 422 validation error.
• 428 missing X-IDEMPOTENCY-KEY from shared idempotency handling.

Field-level constraints:

• Schema Reference