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

# Submit IF-061 with Event Code MDRStart message for validation

`POST /validate/IF-061/MDRStart`

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

## Request body

- object[]
  - `payload` IF061Payload — Request from SDS to initiate an MDR begins Data Retrieval Activity
    - `CommonBlock` object, required
      - `S0` object, required — Sender Header block
        - `interfaceID` 'IF-061', required
        - `schemaVersion` '011', required — Version of the message schema used in the exchange
        - `eventCode` '[MDRStart]', 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.
    - `CustomBlock` object, required — Request from SDS to initiate an MDR begins Data Retrieval Activity Custom Block
      - `B019` B019, required — Assigned MDR
        - `assignedMDRDIPID` string, required — DIP Participant Id
        - `assignedMDRMPID` string, required — Legacy MPID
        - `assignedMDREffectiveFromDate` string, required — ISO 8601 Date/time
      - `B012` B012 — Service Provider Appointment Requesting Supplier
        - `serviceProviderAppointmentRequestingSupplierDIPID` string, required — DIP Participant Id
        - `serviceProviderAppointmentRequestingSupplierMPID` string, required — Legacy MPID
      - `B078` B078, required — Eenrgy Direction
        - `energyDirection` 'I' | 'E', required — Indicates the direction of energy at a metering point. Values can be I = import / E = export
      - `B025` B025, required — MPAN Energisation Info
        - `energisationStatus` 'D' | 'E' | 'U', required — Indicates if the metering point is considered energised (i.e. connected to the distribution system) and therefore active for settlement purposes.
        - `energisationStatusEffectiveFromDate` string, required — ISO 8601 Date/time
      - `B068` B068, required — MPAN Consent Info
        - `consentGranularity` 'H' | 'D' | 'M' | 'N' | 'x', required — Describes the granularity of energy settlement data that a customer has deemed to have consented to.
        - `consentGranularityEffectiveFromDate` string, required — ISO 8601 Date/time
      - `B031` B031 — SMSO Info
        - `SMSOID` string, nullable, required — The Id of the operator a Supplier has procured data and communication services from in respect of a Metering System (applies only to certain types of SMETS1 Metering).
        - `SMSOEffectiveFromDate` string, required — ISO 8601 Date/time
      - `B074List` B074[]
        - `meterID` string, required — Meter ID
        - `meterType` 'CHECK' | 'H' | 'K' | 'LAG_' | 'LEAD_' | 'MAIN_' | 'N' | 'NCAMR' | 'NSS' | 'RCAMR' | 'RCAMY' | 'S' | 'S1' | 'S2A' | 'S2AD' | 'S2ADE' | 'S2B' | 'S2BD' | 'S2BDE' | 'S2C' | 'S2CD' | 'S2CDE' | 'SPECL' | 'T' | '2ADF' | '2ADEF' | '2AEF' | '2AF' | '2BF' | '2BDF' | '2BDEF' | '2BEF' | '2CDEF' | '2CF' | '2CDF' | '2CEF', required — The type of meter, in relation to its capabilities. E.g. AMR.S1, S2, S2ADE
        - `manufacturersMakeAndType` string, nullable, required — The Meter Manufacturer Make and Type
        - `ESMEGUID` string, nullable, required — The Smart Device ID for a smart meter. This is also known as the DCC GUID and is further defined within the DCC interface specifications.
        - `meterLocation` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z', required — The actual location of the metering system within the site
        - `numberOfDisplayedRegisterDigits` integer, nullable, required — Number of digits/dials to the left of the decimal point, of the Cumulative Register.
        - `meterInstallationDate` string, required — ISO 8601 Date/time
      - `B060` B060 — Registration Reminder Add Info
        - `additionalInformation` string, nullable, required — A free format character string for providing additional details.

## 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)