What is the latest version of supl.009?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is supl.009.001.11.

What is the root element of supl.009?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:supl.009.001.11, and its message element is DTCCCAPASD1 (DTCCCAPASD1).

Is there an MT equivalent of supl.009?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

supl: Supplementary Data

supl.009 DTCCCAPASD1

Written and maintained by ZagTrader. Last reviewed 21 October 2026. How this page is sourced and checked

supl.009 is the ISO 20022 DTCCCAPASD1 message in the Supplementary Data business area (supl). The latest version is supl.009.001.11, and 5 versions are in the repository.

Message: DTCCCAPASD1
Latest version: supl.009.001.11
Submitting organisation: Not read from the catalogue
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What supl.009 is for

The DTCCCAPASD1 message extends ISO corporate action movement preliminary advice message with DTCC corporate action elements not covered in the standard message.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

supl.009 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

Version	Registration status	Published in
supl.009.001.11latest	Registered	Latest version set
supl.009.001.10	Registered	Archive
supl.009.001.09	Registered	Archive
supl.009.001.08	Registered	Archive
supl.009.001.07	Registered	Archive

supl.009 message structure

The building blocks of supl.009.001.11 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

Document [1..1]
- DTCCCAPASD1 DTCCCAPASD1 [1..1]
  - CorpActnGnlInf Corporate Action General Information [0..1]CorporateActionGeneralInformationSD58
    Information to be extended as supplementary data to corporate action general information.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - EvtGrp Event Group [0..1]EventGroup1Code
      DTC processing domain/ category for event types.
    - EvtTp Event Type [0..1]ExtendedEventType6Code
      DTCC (The Depository Trust and Clearing Corporation) native corporate action event type name.
    - SubEvtTp Sub Event Type [0..1]DTCCSubEventType11Code
      DTCC (The Depository Trust and Clearing Corporation) native corporate action sub event type name further defines the event type.
    - RedId Redemption Identification [0..1]Max10NumericText
      Unique number systemically assigned to all lottery and non-lottery events announced in DTC redemptions (REDS) participant terminal system (PTS) /...
  - UndrlygScty Underlying Security [0..1]FinancialInstrumentAttributesSD21
    Information to be extended as supplementary data to underlying security details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - OrgtgSctyId Originating Security Identification [0..1]OtherIdentification2
      Represents the 'original' security identifier of the event.
      - Id Identification [1..1]RestrictedFINXMax31Text
      - Sfx Suffix [0..1]Max16Text
      - Tp Type [1..1]IdentificationSource4Choice (choice)
    - MnyMktInstrmFlg Money Market Instrument Flag [0..1]YesNoIndicator
      Indicates that the underlying security is a money market instrument.
  - CorpActnBalDtls Corporate Action Balance Details [0..1]CorporateActionBalanceSD4
    Information to be extended as supplementary data to corporate action balance details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - OrgnlBal Original Balance [0..1]SignedQuantityFormat9
      Position held in a security as of the day prior to publication date.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
    - AdjstdBal Adjusted Balance [0..1]SignedQuantityFormat9
      Adjusted position held in a security that is subject to redemption call.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
    - UpldgdBal Unpledged Balance [0..1]SignedQuantityFormat9
      Portion of the original balance position held in DTC general free account as of day prior to publication date.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
    - InvstmtUpldgdBal Investment Unpledged Balance [0..1]SignedQuantityFormat9
      Portion of the original balance position held in DTC segregated account as of day prior to publication date.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
    - InvstmtPldgdBal Investment Pledged Balance [0..1]SignedQuantityFormat9
      Portion of the original balance position held in DTC investment account as of day prior to publication date.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
    - MemoSgrtnBal Memo Segregation Balance [0..1]SignedQuantityFormat9
      Position held in DTC segregated account.
      - ShrtLngPos Short Long Position [1..1]ShortLong1Code
      - Qty Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
  - CorpActnDtls Corporate Action Details [0..1]CorporateActionSD18
    Information to be extended as supplementary data to corporate action details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - LtrySeqNb Lottery Sequence Number [0..1]Max3NumericText
      DTC generated number to distinguish between the series of lotteries run against a particular redemption.
  - CorpActnMvmntSctiesMvmntDtls Corporate Action Movement Securities Movement Details [0..*]CorporateActionMovementSecuritiesMovementDetailsSD5
    Information to be extended as supplementary data to corporate action movement securities movement details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - CdtDbtInd Credit Debit Indicator [1..1]CreditDebitCode
      Indicates whether the value is a debit or a credit.
    - PyoutTp Payout Type [1..1]DTCCPayoutType4Code
      Specifies the type of payout associated with the event (for example: principal, long term capital gain).
    - TxQty Transaction Quantity [0..1]FinancialInstrumentQuantity15Choice (choice)
      Resulting quantity of securities concerned in this transaction.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
    - RsnCd Reason Code [0..1]DTCAdjustmentPaymentType4Code
      Transaction reason.
    - SubRsnCd Sub Reason Code [0..1]DTCAdjustmentPaymentSubReason2Code
      Transaction sub reason.
    - ContraPtcptNb Contra Participant Number [0..1]Max8Text
      Transaction contra participant identification when shares are distributed / delivered to / from another participant.
    - EarlstPmtDt Earliest Payment Date [0..1]DateFormat48Choice (choice)
      Date/Time on which the posting / draft of the securities is scheduled to take place for a transaction.
      - Dt Date [1..1]DateAndDateTime2Choice (choice)
      - DtCd Date Code [1..1]DateType8Code
    - TaxAdjstmntRate Tax Adjustment Rate [0..1]PercentageRate
      Set of the DTC legacy sub reason codes representing tax rate.
    - RDPRefNb RDP Reference Number [0..1]Exact32AlphaNumericText
      Unique DTCC legacy reference used for matching and reconciling legacy CCF records.
  - CorpActnMvmntCshMvmntDtls Corporate Action Movement Cash Movement Details [0..*]CorporateActionMovementCashMovementDetailsSD5
    Information to be extended as supplementary data to corporate action movement cash movement details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - CdtDbtInd Credit Debit Indicator [1..1]CreditDebitCode
      Indicates whether the value is a debit or a credit.
    - PyoutTp Payout Type [1..1]DTCCPayoutType5Code
      Specifies the type of payout associated with the event (for example: principal, long term capital gain).
    - TxAmt Transaction Amount [0..1]RestrictedFINActiveCurrencyAndAmount
      Resulting cash amount concerned in this transaction.
    - RsnCd Reason Code [0..1]DTCAdjustmentPaymentType4Code
      Transaction reason.
    - SubRsnCd Sub Reason Code [0..1]DTCAdjustmentPaymentSubReason2Code
      Transaction sub reason.
    - ContraPtcptNb Contra Participant Number [0..1]Max8Text
      Transaction contra participant identification when shares are distributed / delivered to / from another participant.
    - EarlstPmtDt Earliest Payment Date [0..1]DateFormat48Choice (choice)
      Date/Time on which the posting / draft of cash is scheduled to take place for a transaction.
      - Dt Date [1..1]DateAndDateTime2Choice (choice)
      - DtCd Date Code [1..1]DateType8Code
    - RDPRefNb RDP Reference Number [0..1]Exact32AlphaNumericText
      Unique DTCC legacy reference used for matching and reconciling legacy CCF records.
    - TaxAdjstmntRate Tax Adjustment Rate [0..1]PercentageRate
      Set of the DTC legacy sub reason codes representing tax rate.
    - TxQty Transaction Quantity [0..1]FinancialInstrumentQuantity15Choice (choice)
      Quantity used on adjustment transactions which when summed across all extension movements equals the relevant balance in the core message.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
  - OptnTxDtls Option Transaction Details [0..*]OptionTransactionDetailsSD3
    Information to be extended as supplementary data to corporate action option details.
    - PlcAndNm Place And Name [0..1]Max350Text
      Xpath to the element that is being extended.
    - TxId Transaction Identification [1..1]Max15Text
      Unique number assigned by the depository.
    - TxSeqNb Transaction Sequence Number [0..1]Max3NumericText
      Number which further identifies DTC instruction reference number.
    - TxIdDt Transaction Identification Date [1..1]ISODateTime
      Instruction date and time for reorganisation instructions or the deposit date for reorganisation / custody deposits.
    - TxIdQty Transaction Identification Quantity [1..1]FinancialInstrumentQuantity15Choice (choice)
      Instructed quantity for reorganisation instructions or the deposit quantity for reorganisation / custody deposits.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
    - EntitldAmt Entitled Amount [0..1]RestrictedFINActiveCurrencyAndAmount
      Amount based upon the DTC cash rate per instruction.
    - EntitldQty Entitled Quantity [0..1]FinancialInstrumentQuantity15Choice (choice)
      Quantity based upon the DTC security rate per instruction.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
    - AgtNtrdQty Agent Entered Quantity [0..1]FinancialInstrumentQuantity15Choice (choice)
      Quantity entered by the agent on PUT (Mortgage Backed) instructions to be paid.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
    - AgtRmngQty Agent Remaining Quantity [0..1]FinancialInstrumentQuantity15Choice (choice)
      Instructed quantity less the quantity entered by Agent on PUT (Mortgage Backed) instructions.
      - Unit Unit [1..1]RestrictedFINDecimalNumber
      - FaceAmt Face Amount [1..1]RestrictedFINImpliedCurrencyAndAmount
      - AmtsdVal Amortised Value [1..1]RestrictedFINImpliedCurrencyAndAmount
    - CstmrRefId Customer Reference Identification [0..1]Max30Text
      Customer identification entered by client upon instruction submission.

Have a supl.009 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in supl.009

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

ExternalFinancialInstrumentIdentificationType1Code24 codes

supl.009 questions

What is the latest version of supl.009?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is supl.009.001.11.
What is the root element of supl.009?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:supl.009.001.11, and its message element is DTCCCAPASD1 (DTCCCAPASD1).
Is there an MT equivalent of supl.009?: No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.