What is the latest version of colr.004?

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

What is the root element of colr.004?

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

Is there an MT equivalent of colr.004?

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.004 Margin Call Response

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

colr.004 is the ISO 20022 MarginCallResponse message in the Collateral Management business area (colr). The latest version is colr.004.001.05, and 3 versions are in the repository.

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

In use: published in the current ISO 20022 catalogue.

What colr.004 is for

The MarginCallResponse message is sent by the collateral giver or its collateral manager to the collateral taker or its collateral manager or vice versa. This is a response to the MarginCallRequest message. The margin call can be accepted, fully disputed or partially disputed.
The message definition is intended for use with the ISO20022 Business Application Header.
When sent by the collateral giver the MarginCallResponse message is used to:
- fully accept the MarginCallRequest
- or partially accept the MarginCallRequest.
When sent by the collateral taker the MarginCallResponse message is used to:
- fully accept the recall of collateral
- or partially accept the recall of collateral.

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

colr.004 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.004.001.05latest	Registered	Latest version set
colr.004.001.04	Registered	Previous version set
colr.004.001.03	Registered	Archive

colr.004 message structure

The building blocks of colr.004.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]
- MrgnCallRspn MarginCallResponse [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
  - MrgnDtlsDueToA Margin Details Due To A [0..1]MarginCall1
    Provides details about the margin calculation that would be due to party A.
    - XpsdAmtPtyA Exposed Amount Party A [0..1]ActiveCurrencyAndAmount
      Sum of the exposures of all transactions which are in the favour of party A.
    - XpsdAmtPtyB Exposed Amount Party B [0..1]ActiveCurrencyAndAmount
      Sum of the exposures of all transactions which are in the favour of party B.
    - XpsrCnvntn Exposure Convention [0..1]ExposureConventionType1Code
      Determines how the variation margin requirement is to be calculated: - either Net, in which the exposure of all transactions in favour of party A and...
    - IndpdntAmtPtyA Independent Amount Party A [0..1]AggregatedIndependentAmount1
      Amount applied as an add-on to the exposure (to party A) usually intended to cover a possible increase in exposure before the next valuation date.
      - Trad Trade [0..1]IndependentAmount1
      - ValAtRsk Value At Risk [0..1]IndependentAmount1
      - NetOpnPos Net Open Position [0..1]IndependentAmount1
      - OthrAmt Other Amount [0..*]IndependentAmount2
    - IndpdntAmtPtyB Independent Amount Party B [0..1]AggregatedIndependentAmount1
      An amount applied as an add-on to the exposure (to party B) usually intended to cover a possible increase in exposure before the next valuation date.
      - Trad Trade [0..1]IndependentAmount1
      - ValAtRsk Value At Risk [0..1]IndependentAmount1
      - NetOpnPos Net Open Position [0..1]IndependentAmount1
      - OthrAmt Other Amount [0..*]IndependentAmount2
    - MrgnTerms Margin Terms [0..1]MarginTerms1Choice (choice)
      Provides information like threshold amount, threshold type, minimum transfer amount, rouding amount or rounding convention, that applies to either...
      - MrgnDtls Margin Details [1..1]Margin1
      - SgrtdIndpdntAmtMrgn Segregated Independent Amount Margin [1..1]SegregatedIndependentAmountMargin1
    - CollBal Collateral Balance [0..1]CollateralBalance1Choice (choice)
      Provides details about the collateral held, in transit or that still needs to be agreed by both parties with a segregation between variation margin...
      - TtlColl Total Collateral [1..1]ActiveCurrencyAndAmount
      - CollDtls Collateral Details [1..1]Collateral1
      - SgrtdIndpdntAmt Segregated Independent Amount [1..1]MarginCollateral1
  - MrgnDtlsDueToB Margin Details Due To B [0..1]MarginCall1
    Provides details about the margin calculation that would be due to party B.
    - XpsdAmtPtyA Exposed Amount Party A [0..1]ActiveCurrencyAndAmount
      Sum of the exposures of all transactions which are in the favour of party A.
    - XpsdAmtPtyB Exposed Amount Party B [0..1]ActiveCurrencyAndAmount
      Sum of the exposures of all transactions which are in the favour of party B.
    - XpsrCnvntn Exposure Convention [0..1]ExposureConventionType1Code
      Determines how the variation margin requirement is to be calculated: - either Net, in which the exposure of all transactions in favour of party A and...
    - IndpdntAmtPtyA Independent Amount Party A [0..1]AggregatedIndependentAmount1
      Amount applied as an add-on to the exposure (to party A) usually intended to cover a possible increase in exposure before the next valuation date.
      - Trad Trade [0..1]IndependentAmount1
      - ValAtRsk Value At Risk [0..1]IndependentAmount1
      - NetOpnPos Net Open Position [0..1]IndependentAmount1
      - OthrAmt Other Amount [0..*]IndependentAmount2
    - IndpdntAmtPtyB Independent Amount Party B [0..1]AggregatedIndependentAmount1
      An amount applied as an add-on to the exposure (to party B) usually intended to cover a possible increase in exposure before the next valuation date.
      - Trad Trade [0..1]IndependentAmount1
      - ValAtRsk Value At Risk [0..1]IndependentAmount1
      - NetOpnPos Net Open Position [0..1]IndependentAmount1
      - OthrAmt Other Amount [0..*]IndependentAmount2
    - MrgnTerms Margin Terms [0..1]MarginTerms1Choice (choice)
      Provides information like threshold amount, threshold type, minimum transfer amount, rouding amount or rounding convention, that applies to either...
      - MrgnDtls Margin Details [1..1]Margin1
      - SgrtdIndpdntAmtMrgn Segregated Independent Amount Margin [1..1]SegregatedIndependentAmountMargin1
    - CollBal Collateral Balance [0..1]CollateralBalance1Choice (choice)
      Provides details about the collateral held, in transit or that still needs to be agreed by both parties with a segregation between variation margin...
      - TtlColl Total Collateral [1..1]ActiveCurrencyAndAmount
      - CollDtls Collateral Details [1..1]Collateral1
      - SgrtdIndpdntAmt Segregated Independent Amount [1..1]MarginCollateral1
  - AgrdAmtDueToA Agreed Amount Due To A [0..1]AgreedAmount1Choice (choice)
    Provides details about the agreed amount that would be due to party A.
    - AgrdAmtDtls Agreed Amount Details [1..1]AgreedAmount1
      Provides details about the agreed amount for the variation margin and optionaly the segregated independent amount.
      - VartnMrgnAmt Variation Margin Amount [1..1]Amount1
      - SgrtdIndpdntAmt Segregated Independent Amount [0..1]Amount1
    - SgrtdIndpdntAmt Segregated Independent Amount [1..1]Amount1
      Provides details about the agreed amount for the segregated independent amount.
      - AgrdAmt Agreed Amount [1..1]ActiveCurrencyAndAmount
      - MrgnCallReqId Margin Call Request Identification [1..1]Max35Text
      - AddtlInf Additional Information [0..1]Max210Text
  - AgrdAmtDueToB Agreed Amount Due To B [0..1]AgreedAmount1Choice (choice)
    Provides details about the agreed amount that would be due to party B.
    - AgrdAmtDtls Agreed Amount Details [1..1]AgreedAmount1
      Provides details about the agreed amount for the variation margin and optionaly the segregated independent amount.
      - VartnMrgnAmt Variation Margin Amount [1..1]Amount1
      - SgrtdIndpdntAmt Segregated Independent Amount [0..1]Amount1
    - SgrtdIndpdntAmt Segregated Independent Amount [1..1]Amount1
      Provides details about the agreed amount for the segregated independent amount.
      - AgrdAmt Agreed Amount [1..1]ActiveCurrencyAndAmount
      - MrgnCallReqId Margin Call Request Identification [1..1]Max35Text
      - AddtlInf Additional Information [0..1]Max210Text
  - RspnDtls Response Details [0..1]Response1
    Provides response details about the margin call.
    - RspnTpDtls Response Type Details [1..*]ResponseType1Choice (choice)
      Provides details about the response type.
      - Cd Code [1..1]MarginCallResponse1Code
      - Prtry Proprietary [1..1]GenericIdentification30
    - Desc Description [0..1]Max140Text
      Provides additional details related to the margin call response.
  - 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.004 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.004 questions

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