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

# Submit IF-020 with Event Code LinkedImportExportAdd message for validation

`POST /validate/IF-020/LinkedImportExportAdd`

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

## Request body

- object[]
  - `payload` IF020LinkedImportExportAdd
    - `CommonBlock` object, required — MHHS Common Block for IF-020-LinkedImportExportCreate
      - `S0` object, required — Sender Header block
        - `interfaceID` 'IF-020', required
        - `schemaVersion` '011', required — Version of the message schema used in the exchange
        - `eventCode` '[LinkedImportExportAdd]', 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
      - `M1` M1, required — Principal MPAN
        - `principalMPAN` 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 — IF020 Custom data block
      - `B090List` B090[], required
        - `subsidiaryMPAN` string, required — MPAN Core
      - `B091` B091 — MPAN Relationship Additional Infromation
        - `additionalInformation` string, nullable, required — A free format character string for providing additional details.
      - `B907List` B907[]
        - `existingMeter` B035, required — Linked Import/Export MPAN Info
          - `linkedImportExportMPAN` string, required — MPAN Core
          - `linkedMPANEnergyDirection` 'I' | 'E', required — The Energy Direction (Import or Export) of a Linked MPAN
          - `importExportMPANSupplierDIPID` string, nullable, required — DIP Participant Id
          - `importExportMPANSupplierMPID` string, nullable, required — Legacy MPID
        - `historyMAP` B910[]
          - `existingMeter` B036, required — Linked Import/Export Meter Info
            - `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
          - `historyMAP` B075[]
            - `meterAssetProviderID` string, required — The market-wide reference for the provider of the meter equipment.
            - `meterAssetProviderEffectiveFromDate` string, required — ISO 8601 Date/time

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