What is the latest version of colr.010?

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

What is the root element of colr.010?

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

Is there an MT equivalent of colr.010?

Yes. colr.010 does the same business job as MT505. Field-level translation has gaps in both directions.

colr: Collateral Management

colr.010 Collateral Substitution Request

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

colr.010 is the ISO 20022 CollateralSubstitutionRequest message in the Collateral Management business area (colr). The latest version is colr.010.001.05, and 3 versions are in the repository.

Message: CollateralSubstitutionRequest
Latest version: colr.010.001.05
Submitting organisation: Swift, FPL, ISDA/FpML, ISITC
MT equivalent: MT505

In use: published in the current ISO 20022 catalogue.

What colr.010 is for

The CollateralSubstitutionRequest message is sent by either the collateral giver or its collateral manager to the collateral taker or its collateral manager. It is used to request a substitution of collateral by specifying the collateral to be returned and proposing the new type(s) of collateral to be delivered. Note: There are cases where the collateral taker can initiate the CollateralSubstitutionRequest message, for example in case of breach in the concentration limit.
The message definition is intended for use with the ISO20022 Business Application Header.
The CollateralSubstitutionRequest message can be sent by either the collateral giver or collateral taker in order to substitute collateral that is already held by the other party.

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

colr.010 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.010.001.05latest	Registered	Latest version set
colr.010.001.04	Registered	Previous version set
colr.010.001.03	Registered	Archive

colr.010 message structure

The building blocks of colr.010.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]
- CollSbstitnReq CollateralSubstitutionRequest [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
  - CollSbstitnRtr Collateral Substitution Return [1..1]CollateralSubstitution7
    Provides details about the collateral that will be returned.
    - CollSbstitnSeq Collateral Substitution Sequence [1..1]CollateralSubstitutionSequence1Code
      Indicates whether the collateral substitution request is new or updated.
    - SbstitnRqrmnt Substitution Requirement [1..1]ActiveCurrencyAndAmount
      Cash value of the requested collateral substitution transfer in the base currency.
    - CollSbstitnTp Collateral Substitution Type [1..1]CollateralSubstitutionType1Code
      Specifies if the collateral that is substituted was posted against the variation margin or the independent amount.
    - StdSttlmInstrs Standard Settlement Instructions [0..1]Max140Text
      Identifies the standard settlement instructions.
    - SctiesColl Securities Collateral [0..*]SecuritiesCollateral11
      Collateral type is securities.
      - CollId Collateral Identification [0..1]Max35Text
      - AsstNb Asset Number [0..1]Max35Text
      - SctyId Security Identification [1..1]SecurityIdentification19
      - MtrtyDt Maturity Date [0..1]DateAndDateTime2Choice (choice)
      - LtdCvrgInd Limited Coverage Indicator [0..1]YesNoIndicator
      - Qty Quantity [1..1]FinancialInstrumentQuantity33Choice (choice)
      - Pric Price [0..1]Price7
      - MktVal Market Value [0..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
      - CollVal Collateral Value [0..1]ActiveCurrencyAndAmount
      - ValDt Value Date [0..1]ISODate
      - SfkpgAcct Safekeeping Account [0..1]SecuritiesAccount19
      - BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]BlockChainAddressWallet3
      - SfkpgPlc Safekeeping Place [1..1]SafekeepingPlaceFormat29Choice (choice)
      - SttlmParams Settlement Parameters [0..1]SettlementDetails206
    - CshColl Cash Collateral [0..*]CashCollateral5
      Collateral type is cash.
      - CollId Collateral Identification [0..1]Max35Text
      - CshAcctId Cash Account Identification [0..1]AccountIdentification4Choice (choice)
      - AsstNb Asset Number [0..1]Max35Text
      - DpstAmt Deposit Amount [0..1]ActiveCurrencyAndAmount
      - DpstTp Deposit Type [0..1]DepositType1Code
      - MtrtyDt Maturity Date [0..1]ISODate
      - ValDt Value Date [0..1]ISODate
      - XchgRate Exchange Rate [0..1]BaseOneRate
      - CollVal Collateral Value [1..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
    - OthrColl Other Collateral [0..*]OtherCollateral11
      Collateral type is other than securities or cash for example letter of credit.
      - CollId Collateral Identification [0..1]Max35Text
      - AsstNb Asset Number [0..1]Max35Text
      - LttrOfCdtId Letter Of Credit Identification [0..1]Max35Text
      - LttrOfCdtAmt Letter Of Credit Amount [0..1]ActiveCurrencyAndAmount
      - GrntAmt Guarantee Amount [0..1]ActiveCurrencyAndAmount
      - OthrTpOfColl Other Type Of Collateral [0..1]OtherTypeOfCollateral3
      - IsseDt Issue Date [0..1]DateFormat14Choice (choice)
      - XpryDt Expiry Date [0..1]DateFormat14Choice (choice)
      - LtdCvrgInd Limited Coverage Indicator [0..1]YesNoIndicator
      - Issr Issuer [0..1]PartyIdentification178Choice (choice)
      - ValDt Value Date [0..1]ISODate
      - XchgRate Exchange Rate [0..1]BaseOneRate
      - MktVal Market Value [0..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
      - CollVal Collateral Value [1..1]ActiveCurrencyAndAmount
      - SfkpgPlc Safekeeping Place [0..1]SafekeepingPlaceFormat29Choice (choice)
      - SfkpgAcct Safekeeping Account [0..1]SecuritiesAccount19
      - BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]BlockChainAddressWallet3
    - LkdRefs Linked References [0..1]Reference17
      Provides details on the identification of previously sent and/or received message(s), in case of updated substitution request.
      - CollSbstitnReqId Collateral Substitution Request Identification [1..1]Max35Text
      - CollSbstitnRspnId Collateral Substitution Response Identification [0..1]Max35Text
  - CollSbstitnDlvr Collateral Substitution Deliver [0..1]CollateralSubstitution8
    Provides details about the collateral that will be delivered.
    - CollSbstitnSeq Collateral Substitution Sequence [1..1]CollateralSubstitutionSequence1Code
      Indicates whether the collateral substitution request is new or updated.
    - SbstitnRqrmnt Substitution Requirement [1..1]ActiveCurrencyAndAmount
      Cash value of the requested collateral substitution transfer in the base currency.
    - CollSbstitnTp Collateral Substitution Type [1..1]CollateralSubstitutionType1Code
      Specifies if the collateral that is substituted was posted against the variation margin or the independent amount.
    - StdSttlmInstrs Standard Settlement Instructions [0..1]Max140Text
      Identifies the standard settlement instructions.
    - SctiesColl Securities Collateral [0..*]SecuritiesCollateral12
      Collateral type is securities.
      - CollId Collateral Identification [0..1]Max35Text
      - SctyId Security Identification [1..1]SecurityIdentification19
      - MtrtyDt Maturity Date [0..1]DateAndDateTime2Choice (choice)
      - LtdCvrgInd Limited Coverage Indicator [0..1]YesNoIndicator
      - Qty Quantity [1..1]FinancialInstrumentQuantity33Choice (choice)
      - Pric Price [0..1]Price7
      - MktVal Market Value [0..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
      - CollVal Collateral Value [0..1]ActiveCurrencyAndAmount
      - ValDt Value Date [0..1]ISODate
      - SfkpgAcct Safekeeping Account [0..1]SecuritiesAccount19
      - BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]BlockChainAddressWallet3
      - SfkpgPlc Safekeeping Place [1..1]SafekeepingPlaceFormat29Choice (choice)
      - SttlmParams Settlement Parameters [0..1]SettlementDetails206
    - CshColl Cash Collateral [0..*]CashCollateral3
      Collateral type is cash.
      - CollId Collateral Identification [0..1]Max35Text
      - CshAcctId Cash Account Identification [0..1]AccountIdentification4Choice (choice)
      - DpstAmt Deposit Amount [0..1]ActiveCurrencyAndAmount
      - DpstTp Deposit Type [0..1]DepositType1Code
      - MtrtyDt Maturity Date [0..1]ISODate
      - ValDt Value Date [0..1]ISODate
      - XchgRate Exchange Rate [0..1]BaseOneRate
      - CollVal Collateral Value [1..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
    - OthrColl Other Collateral [0..*]OtherCollateral9
      Collateral type is other than securities or cash for example letter of credit.
      - CollId Collateral Identification [0..1]Max35Text
      - LttrOfCdtId Letter Of Credit Identification [0..1]Max35Text
      - LttrOfCdtAmt Letter Of Credit Amount [0..1]ActiveCurrencyAndAmount
      - GrntAmt Guarantee Amount [0..1]ActiveCurrencyAndAmount
      - OthrTpOfColl Other Type Of Collateral [0..1]OtherTypeOfCollateral3
      - IsseDt Issue Date [0..1]DateFormat14Choice (choice)
      - XpryDt Expiry Date [0..1]DateFormat14Choice (choice)
      - LtdCvrgInd Limited Coverage Indicator [0..1]YesNoIndicator
      - Issr Issuer [0..1]PartyIdentification178Choice (choice)
      - ValDt Value Date [0..1]ISODate
      - XchgRate Exchange Rate [0..1]BaseOneRate
      - MktVal Market Value [0..1]ActiveCurrencyAndAmount
      - Hrcut Haircut [0..1]PercentageRate
      - CollVal Collateral Value [1..1]ActiveCurrencyAndAmount
      - SfkpgPlc Safekeeping Place [0..1]SafekeepingPlaceFormat29Choice (choice)
      - SfkpgAcct Safekeeping Account [0..1]SecuritiesAccount19
      - BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]BlockChainAddressWallet3
    - LkdRefs Linked References [0..1]Reference17
      Provides details on the identification of previously sent and/or received message(s), in case of updated substitution request.
      - CollSbstitnReqId Collateral Substitution Request Identification [1..1]Max35Text
      - CollSbstitnRspnId Collateral Substitution Response Identification [0..1]Max35Text
  - 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.010 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 colr.010

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

colr.010 questions

What is the latest version of colr.010?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is colr.010.001.05.
What is the root element of colr.010?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.010.001.05, and its message element is CollSbstitnReq (CollateralSubstitutionRequest).
Is there an MT equivalent of colr.010?: Yes. colr.010 does the same business job as MT505. Field-level translation has gaps in both directions.

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.