---
title: "Submit IF-028 with Event Code ConsumptionAmendment message for validation"
method: POST
path: "/validate/IF-028/ConsumptionAmendment"
tags: ["DIP Message Validation Endpoints"]
---

# Submit IF-028 with Event Code ConsumptionAmendment message for validation

`POST /validate/IF-028/ConsumptionAmendment`

Allows a Market Participant to validate a single messages for debugging purposes only

## Request body

- object[]
  - `payload` IF028Payload — IF-028 Supplier Consumption Ammendment Request Response
    - `CommonBlock` object, required — MHHS Common Block for IF-028
      - `S0` object, required — Sender Header block
        - `interfaceID` 'IF-028', required
        - `schemaVersion` '011', required — Version of the message schema used in the exchange
        - `eventCode` '[ConsumptionAmendment]', required
      - `S1` S1, required — Sender Common block
        - `environmentTag` 'PRD' | 'SITB' | 'SIT' | 'UIT' | 'DEV', required — Environment Tag
        - `subText` string, nullable, required — SubText
        - `senderUniqueReference` string, required — Sender Unique Reference
        - `senderTimestamp` string, required — ISO 8601 Date/time
        - `senderDIPID` string, required — DIP Participant Id
        - `senderRoleID` string, required — DIP Participant Role
        - `senderCorrelationID` string, nullable, required — Correlation Id
        - `DIPConnectionProviderID` string, nullable, required — DIP Participant Id
      - `A0` A0 — Addressing block
        - `primaryRecipients` DT006NDIPParticipantID[], required — Primary Recipient - array of Ids; set by Sender
        - `secondaryRecipients` DT006NDIPParticipantID[], required — Secondary Recipient - array of Ids; set by DIP
        - `always` DT006NDIPParticipantID[], required — Always Recipient - array of Ids; set by DIP
      - `D0` D0 — DIP Block
        - `transactionID` string, required — Transaction ID
        - `transactionTimestamp` string, required — ISO 8601 Date/time
        - `publicationID` string, required — DIP Publication ID
        - `initialCorrelationID` string, nullable, required — Correlation Id
        - `replayIndicator` boolean, required — Set by the DIP to denote that a txn is being replayed
        - `serviceTicketURL` string, nullable, required — URL
      - `M0` M0, required — MPAN Core
        - `MPANCore` string, required — MPAN Core
        - `distributorDIPID` string, required — DIP Participant Id
        - `GSPGroupID` '_A' | '_B' | '_C' | '_D' | '_E' | '_F' | '_G' | '_H' | '_J' | '_K' | '_L' | '_M' | '_N' | '_P', required — Identifies the distinct grid supply point group (physical region of the country) where the metering point is located.
      - `R0` R0, required — Response Block
        - `responseCode` 'A' | 'R' | 'L' | 'W' | 'x', required — Outcome Code associated with a Business Process Action Request
        - `responseMessages` DT005NStatusErrorMessage[], required — Response message outcomes
    - `CustomBlock` object, required — IF028 Custom data block
      - `B902List` B902[], required — MQID (B045) Supplier Consumption Ammendment Requests
        - `MQID` B045, required — MQ ID
          - `measurementQuantityID` 'AI' | 'AE' | 'RI' | 'RE', required — Identifies the type of the quantity that is measured by the Settlement Period Value.
        - `supplierConsumptionAmendmentRequests` B073[], required
          - `consumptionAmendmentSupplierReference` string, nullable, required — Supplier's own internal reference for the Consumption Amendment
          - `consumptionAmendmentPeriodStartDate` string, required — ISO 8601 Date/time
          - `consumptionAmendmentPeriodEndDate` string, required — ISO 8601 Date/time
          - `grossRevisedConsumption` string, required — kWh Consumption (9,3) format - leading
          - `arc` 'A' | 'E' | 'M' | 'R' | 'S' | 'T' | 'X', nullable, required — Consumption Amendment Reason Code

## Response `201`

Message OK

- string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/elexon/apis/mhhs-dip.md) · [All operations](https://skmtc.net/elexon/apis/mhhs-dip/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/mhhs-dip/versions/d3e2d9f8faff/schema)