What is the latest version of colr.012?

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

What is the root element of colr.012?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.012.001.05, and its message element is CollSbstitnConf (CollateralSubstitutionConfirmation).

Is there an MT equivalent of colr.012?

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

colr: Collateral Management

colr.012 Collateral Substitution Confirmation

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

colr.012 is the ISO 20022 CollateralSubstitutionConfirmation message in the Collateral Management business area (colr). The latest version is colr.012.001.05, and 3 versions are in the repository.

Message: CollateralSubstitutionConfirmation
Latest version: colr.012.001.05
Submitting organisation: Swift, FPL, ISDA/FpML, ISITC
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What colr.012 is for

The CollateralSubstitutionConfirmation message is sent by:
- the collateral taker or its collateral manager to the collateral giver or its collateral manager, or
- the collateral giver or its collateral manager to the collateral taker or its collateral manager.
This message confirms the collateral delivery. The collateral taker will only release the return of collateral when the new piece of collateral is received. The collateral giver sends the collateral taker the notification that the collateral substitution (that is new piece(s) of collateral) have been released. In the event that multiple pieces of collateral are being delivered in place of the collateral due to be returned by the giver, this message should only be generated once all collateral pieces have been agreed between both parties. Then the taker confirms that the collateral substitution (that is all pieces have been received) and acknowledges return of collateral.
The message definition is intended for use with the ISO20022 Business Application Header.
This message confirms the collateral delivery. The collateral taker will only release the return of collateral when the new piece of collateral is received. The collateral giver sends the collateral taker the notification that the collateral substitution (that is new piece(s) of collateral) have been released.

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

colr.012 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
colr.012.001.05latest	Registered	Latest version set
colr.012.001.04	Registered	Previous version set
colr.012.001.03	Registered	Archive

colr.012 message structure

The building blocks of colr.012.001.05 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]
- CollSbstitnConf CollateralSubstitutionConfirmation [1..1]
  - TxId Transaction Identification [1..1]Max35Text
    Unambiguous identification of the transaction as know by the instructing party.
  - Oblgtn Obligation [1..1]Obligation9
    Provides information like the identification of the party or parties associated with the collateral agreement, the exposure type and the valuation date.
    - PtyA Party A [1..1]PartyIdentification178Choice (choice)
      Defines one of the entities associated with the collateral agreement.
      - AnyBIC Any BIC [1..1]AnyBICDec2014Identifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification36
      - NmAndAdr Name And Address [1..1]NameAndAddress6
    - SvcgPtyA Servicing Party A [0..1]PartyIdentification178Choice (choice)
      Specifies the party that is acting on behalf of party A and that offers collateral management services.
      - AnyBIC Any BIC [1..1]AnyBICDec2014Identifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification36
      - NmAndAdr Name And Address [1..1]NameAndAddress6
    - PtyB Party B [1..1]PartyIdentification178Choice (choice)
      Defines the other entity associated with the collateral agreement.
      - AnyBIC Any BIC [1..1]AnyBICDec2014Identifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification36
      - NmAndAdr Name And Address [1..1]NameAndAddress6
    - SvcgPtyB Servicing Party B [0..1]PartyIdentification178Choice (choice)
      Specifies the party that is acting on behalf of party B and that offers collateral management services.
      - AnyBIC Any BIC [1..1]AnyBICDec2014Identifier
      - PrtryId Proprietary Identification [1..1]GenericIdentification36
      - NmAndAdr Name And Address [1..1]NameAndAddress6
    - CollAcctId Collateral Account Identification [0..1]CollateralAccount3
      Provides additional information on the collateral account of the party delivering/receiving the collateral.
      - Id Identification [1..1]Max35Text
      - Tp Type [0..1]CollateralAccountIdentificationType3Choice (choice)
      - Nm Name [0..1]Max70Text
    - BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]BlockChainAddressWallet5
      Blockchain address or wallet where digital assets are maintained.
      - Id Identification [1..1]Max140Text
      - Tp Type [0..1]CollateralAccountIdentificationType3Choice (choice)
      - Nm Name [0..1]Max70Text
    - XpsrTp Exposure Type [0..1]ExposureType11Code
      Specifies the underlying business area or type of trade causing the collateral movement.
    - ValtnDt Valuation Date [1..1]DateAndDateTime2Choice (choice)
      Indicates the close of business date on which the initiating party is valuing the margin call.
      - Dt Date [1..1]ISODate
      - DtTm Date Time [1..1]ISODateTime
  - Agrmt Agreement [0..1]Agreement4
    Agreement details for the over the counter market.
    - AgrmtDtls Agreement Details [1..1]Max140Text
      Full details of the supporting legal agreement under which the margin call can be issued and/or governed.
    - AgrmtId Agreement Identification [0..1]Max140Text
      Common reference to the agreement between the two counterparties.
    - AgrmtDt Agreement Date [1..1]ISODate
      Date on which the collateral agreement was signed.
    - BaseCcy Base Currency [1..1]ActiveCurrencyCode
      Denomination currency as specified in the collateral agreement.
    - AgrmtFrmwk Agreement Framework [0..1]AgreementFramework1Choice (choice)
      Specifies the underlying master agreement.
      - AgrmtFrmwk Agreement Framework [1..1]AgreementFramework1Code
      - PrtryId Proprietary Identification [1..1]GenericIdentification30
  - SbstitnConf Substitution Confirmation [1..1]CollateralConfirmation1
    Provides the status about the collateral substitution.
    - CollSbstitnReqId Collateral Substitution Request Identification [1..1]Max35Text
      Reference to the collateral substitution request identification.
    - CollSbstitnRspnId Collateral Substitution Response Identification [0..1]Max35Text
      Reference to the collateral substitution response identification.
    - ConfTp Confirmation Type [1..1]CollateralSubstitutionConfirmation1Code
      Provides details about the status of the collateral substitution, either released or returned.
    - Cmnt Comment [0..1]Max140Text
      Allows to provides additional comments on the collateral substitution status.
  - SplmtryData Supplementary Data [0..*]SupplementaryData1
    Additional information that can not be captured in the structured fields and/or any other specific block.
    - PlcAndNm Place And Name [0..1]Max350Text
      Unambiguous reference to the location where the supplementary data must be inserted in the message instance.
    - Envlp Envelope [1..1]SupplementaryDataEnvelope1
      Technical element wrapping the supplementary data.

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

colr.012 questions

What is the latest version of colr.012?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is colr.012.001.05.
What is the root element of colr.012?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.012.001.05, and its message element is CollSbstitnConf (CollateralSubstitutionConfirmation).
Is there an MT equivalent of colr.012?: 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.