colr: Collateral Management
colr.009 Margin Call Dispute Notification
Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked
colr.009 is the ISO 20022 MarginCallDisputeNotification message in the Collateral Management business area (colr). The latest version is colr.009.001.05, and 3 versions are in the repository.
- Message
- MarginCallDisputeNotification
- Latest version
- colr.009.001.05
- Submitting organisation
- Swift, FPL, ISDA/FpML, ISITC
- MT equivalent
- None listed
In use: published in the current ISO 20022 catalogue.
What colr.009 is for
The MarginCallDisputeNotification message is sent by the collateral taker or its collateral manager to the collateral giver or its collateral manager to acknowledge the notification of the dispute (either full or partial dispute) of the MarginCallRequest. The message will detail the amount of the dispute and the reason.
The message definition is intended for use with the ISO20022 Business Application Header.
When there is a dispute by the collateral giver to the collateral taker a MarginCallDisputeNotification message is sent with the disputed amount (full or partial) stating the reason why the margin call is being disputed.
colr.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 |
|---|---|---|
| colr.009.001.05latest | Registered | Latest version set |
| colr.009.001.04 | Registered | Previous version set |
| colr.009.001.03 | Registered | Archive |
colr.009 message structure
The building blocks of colr.009.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]MrgnCallDsptNtfctnMarginCallDisputeNotification [1..1]TxIdTransaction Identification [1..1]Max35TextUnambiguous identification of the transaction as know by the instructing party.
OblgtnObligation [1..1]Obligation9Provides information like the identification of the party or parties associated with the collateral agreement, the exposure type and the valuation date.
PtyAParty A [1..1]PartyIdentification178Choice (choice)Defines one of the entities associated with the collateral agreement.
AnyBICAny BIC [1..1]AnyBICDec2014IdentifierPrtryIdProprietary Identification [1..1]GenericIdentification36NmAndAdrName And Address [1..1]NameAndAddress6
SvcgPtyAServicing Party A [0..1]PartyIdentification178Choice (choice)Specifies the party that is acting on behalf of party A and that offers collateral management services.
AnyBICAny BIC [1..1]AnyBICDec2014IdentifierPrtryIdProprietary Identification [1..1]GenericIdentification36NmAndAdrName And Address [1..1]NameAndAddress6
PtyBParty B [1..1]PartyIdentification178Choice (choice)Defines the other entity associated with the collateral agreement.
AnyBICAny BIC [1..1]AnyBICDec2014IdentifierPrtryIdProprietary Identification [1..1]GenericIdentification36NmAndAdrName And Address [1..1]NameAndAddress6
SvcgPtyBServicing Party B [0..1]PartyIdentification178Choice (choice)Specifies the party that is acting on behalf of party B and that offers collateral management services.
AnyBICAny BIC [1..1]AnyBICDec2014IdentifierPrtryIdProprietary Identification [1..1]GenericIdentification36NmAndAdrName And Address [1..1]NameAndAddress6
CollAcctIdCollateral Account Identification [0..1]CollateralAccount3Provides additional information on the collateral account of the party delivering/receiving the collateral.
IdIdentification [1..1]Max35TextTpType [0..1]CollateralAccountIdentificationType3Choice (choice)NmName [0..1]Max70Text
BlckChainAdrOrWlltBlock Chain Address Or Wallet [0..1]BlockChainAddressWallet5Blockchain address or wallet where digital assets are maintained.
IdIdentification [1..1]Max140TextTpType [0..1]CollateralAccountIdentificationType3Choice (choice)NmName [0..1]Max70Text
XpsrTpExposure Type [0..1]ExposureType11CodeSpecifies the underlying business area or type of trade causing the collateral movement.
ValtnDtValuation Date [1..1]DateAndDateTime2Choice (choice)Indicates the close of business date on which the initiating party is valuing the margin call.
DtDate [1..1]ISODateDtTmDate Time [1..1]ISODateTime
DsptNtfctnDispute Notification [1..1]DisputeNotification2Choice (choice)Details of the dispute notification.
DsptNtfctnDtlsDispute Notification Details [1..1]DisputeNotification2Provides the dispute notification details for the variation margin and optionaly the segregated independent amount.
VartnMrgnDsptVariation Margin Dispute [1..1]VariationMarginDispute1SgrtdIndpdntAmtDsptSegregated Independent Amount Dispute [0..1]SegregatedIndependentAmountDispute2
SgrtdIndpdntAmtDsptDtlsSegregated Independent Amount Dispute Details [1..1]SegregatedIndependentAmountDispute2Provides the dispute notification details for the segregated independent amount only.
DsptDtlsDispute Details [1..1]Dispute1DsptRsltnTp1ChcDispute Resolution Type1 Choice [0..*]DisputeResolutionType1Choice (choice)
SplmtryDataSupplementary Data [0..*]SupplementaryData1Additional information that cannot be captured in the structured elements and/or any other specific block.
PlcAndNmPlace And Name [0..1]Max350TextUnambiguous reference to the location where the supplementary data must be inserted in the message instance.
EnvlpEnvelope [1..1]SupplementaryDataEnvelope1Technical element wrapping the supplementary data.
Have a colr.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.
colr.009 questions
- What is the latest version of colr.009?
- The latest version in the ISO 20022 e-Repository release of 24 April 2025 is colr.009.001.05.
- What is the root element of colr.009?
- The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.009.001.05, and its message element is MrgnCallDsptNtfctn (MarginCallDisputeNotification).
- Is there an MT equivalent of colr.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.