What is the latest version of colr.003?

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

What is the root element of colr.003?

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

Is there an MT equivalent of colr.003?

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

colr: Collateral Management

colr.003 Margin Call Request

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

colr.003 is the ISO 20022 MarginCallRequest message in the Collateral Management business area (colr). The latest version is colr.003.001.05, and 3 versions are in the repository.

Message: MarginCallRequest
Latest version: colr.003.001.05
Submitting organisation: Swift, FPL, ISDA/FpML, ISITC
MT equivalent: MT503

In use: published in the current ISO 20022 catalogue.

What colr.003 is for

The MarginCallRequest message is sent by the collateral taker or its collateral manager to the collateral giver or its collateral manager
This message is used to request new collateral at the initiation of an exposure or request additional collateral for an existing exposure. It can also be used to recall collateral upon the collateral giver or its collateral manager's request.
The message definition is intended for use with the ISO20022 Business Application Header.
When sent by the collateral taker the MarginCallRequest message is used to:
- request new collateral at the initiation of an exposure
- request additional collateral
When sent by the collateral giver the MarginCallRequest message is used to:
- request the return of collateral.

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

colr.003 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.003.001.05latest	Registered	Latest version set
colr.003.001.04	Registered	Previous version set
colr.003.001.03	Registered	Archive

colr.003 message structure

The building blocks of colr.003.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]
- MrgnCallReq MarginCallRequest [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
  - MrgnCallRslt Margin Call Result [1..1]MarginCallResult3
    Summation of the call amounts per margin type.
    - DfltFndAmt Default Fund Amount [0..1]ActiveCurrencyAndAmount
      Specifies the total amount required by the clearing member to participate to the default fund.
    - MrgnCallRslt Margin Call Result [1..1]MarginCallResult2Choice (choice)
      Provides the summation of the call amounts for the variation margin and the segregated independent amount or the segregated independent amount only...
      - MrgnCallRsltDtls Margin Call Result Details [1..1]MarginCallResult2
      - MrgnCallAmt Margin Call Amount [1..1]Result1
      - SgrtdIndpdntAmt Segregated Independent Amount [1..1]Result1
  - 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
  - RqrmntDtlsDueToA Requirement Details Due To A [0..1]MarginRequirement1Choice (choice)
    Amount of expected margin that will be either delivered to party A by party B or recalled to party A from party B.
    - MrgnRqrmnt Margin Requirement [1..1]Requirement1
      Provides details about the margin requirements for the variation margin and optionally the segregated independent amount.
      - VartnMrgnRqrmnt Variation Margin Requirement [1..1]MarginRequirement1
      - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [0..1]MarginRequirement1
    - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [1..1]MarginRequirement1
      Provides details about the margin requirements for the segregated independent amount only.
      - DlvrMrgnAmt Deliver Margin Amount [0..1]ActiveCurrencyAndAmount
      - RtrMrgnAmt Return Margin Amount [0..1]ActiveCurrencyAndAmount
  - RqrmntDtlsDueToB Requirement Details Due To B [0..1]MarginRequirement1Choice (choice)
    Amount of expected margin that will be either delivered to party B by party A or recalled to party B from party A.
    - MrgnRqrmnt Margin Requirement [1..1]Requirement1
      Provides details about the margin requirements for the variation margin and optionally the segregated independent amount.
      - VartnMrgnRqrmnt Variation Margin Requirement [1..1]MarginRequirement1
      - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [0..1]MarginRequirement1
    - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [1..1]MarginRequirement1
      Provides details about the margin requirements for the segregated independent amount only.
      - DlvrMrgnAmt Deliver Margin Amount [0..1]ActiveCurrencyAndAmount
      - RtrMrgnAmt Return Margin Amount [0..1]ActiveCurrencyAndAmount
  - XpctdCollDueToA Expected Collateral Due To A [0..1]ExpectedCollateral2Choice (choice)
    Provides details about the type of collateral that will be either delivered to party A by party B or recalled to party A from party B.
    - XpctdCollDtls Expected Collateral Details [1..1]ExpectedCollateral2
      Provides the expected collateral type and direction for the variation margin and optionaly the segregated independent amount.
      - VartnMrgn Variation Margin [1..1]ExpectedCollateralMovement2
      - SgrtdIndpdntAmt Segregated Independent Amount [0..1]ExpectedCollateralMovement2
    - SgrtdIndpdntAmt Segregated Independent Amount [1..1]ExpectedCollateralMovement2
      Provides the expected collateral type and direction for the segregated independent amount.
      - Dlvry Delivery [0..*]CollateralMovement9
      - Rtr Return [0..*]CollateralMovement9
  - XpctdCollDueToB Expected Collateral Due To B [0..1]ExpectedCollateral2Choice (choice)
    Provides details about the type of collateral that will be either delivered to party B by party A or recalled to party B from party A.
    - XpctdCollDtls Expected Collateral Details [1..1]ExpectedCollateral2
      Provides the expected collateral type and direction for the variation margin and optionaly the segregated independent amount.
      - VartnMrgn Variation Margin [1..1]ExpectedCollateralMovement2
      - SgrtdIndpdntAmt Segregated Independent Amount [0..1]ExpectedCollateralMovement2
    - SgrtdIndpdntAmt Segregated Independent Amount [1..1]ExpectedCollateralMovement2
      Provides the expected collateral type and direction for the segregated independent amount.
      - Dlvry Delivery [0..*]CollateralMovement9
      - Rtr Return [0..*]CollateralMovement9
  - MrgnCallDtls Margin Call Details [0..*]MarginCall3
    Allows the reporting of the margin requirements for multiple accounts and report a single margin call amount made up of the aggregate of all the individual requirement amounts.
    - 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
    - MrgnCallRslt Margin Call Result [1..1]MarginCallResult3
      Summation of the call amounts per margin type.
      - DfltFndAmt Default Fund Amount [0..1]ActiveCurrencyAndAmount
      - MrgnCallRslt Margin Call Result [1..1]MarginCallResult2Choice (choice)
    - MrgnDtlDueToA Margin Detail 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
      - XpsdAmtPtyB Exposed Amount Party B [0..1]ActiveCurrencyAndAmount
      - XpsrCnvntn Exposure Convention [0..1]ExposureConventionType1Code
      - IndpdntAmtPtyA Independent Amount Party A [0..1]AggregatedIndependentAmount1
      - IndpdntAmtPtyB Independent Amount Party B [0..1]AggregatedIndependentAmount1
      - MrgnTerms Margin Terms [0..1]MarginTerms1Choice (choice)
      - CollBal Collateral Balance [0..1]CollateralBalance1Choice (choice)
    - MrgnDtlDueToB Margin Detail 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
      - XpsdAmtPtyB Exposed Amount Party B [0..1]ActiveCurrencyAndAmount
      - XpsrCnvntn Exposure Convention [0..1]ExposureConventionType1Code
      - IndpdntAmtPtyA Independent Amount Party A [0..1]AggregatedIndependentAmount1
      - IndpdntAmtPtyB Independent Amount Party B [0..1]AggregatedIndependentAmount1
      - MrgnTerms Margin Terms [0..1]MarginTerms1Choice (choice)
      - CollBal Collateral Balance [0..1]CollateralBalance1Choice (choice)
    - RqrmntDtlsDueToA Requirement Details Due To A [0..1]MarginRequirement1Choice (choice)
      Amount of expected margin that will be either delivered to party A by party B or recalled to party A from party B.
      - MrgnRqrmnt Margin Requirement [1..1]Requirement1
      - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [1..1]MarginRequirement1
    - RqrmntDtlsDueToB Requirement Details Due To B [0..1]MarginRequirement1Choice (choice)
      Amount of expected margin that will be either delivered to party B by party A or recalled to party B from party A.
      - MrgnRqrmnt Margin Requirement [1..1]Requirement1
      - SgrtdIndpdntAmtRqrmnt Segregated Independent Amount Requirement [1..1]MarginRequirement1
    - XpctdCollDueToA Expected Collateral Due To A [0..1]ExpectedCollateral2Choice (choice)
      Provides details about the type of collateral that will be either delivered to party A by party B or recalled to party A from party B.
      - XpctdCollDtls Expected Collateral Details [1..1]ExpectedCollateral2
      - SgrtdIndpdntAmt Segregated Independent Amount [1..1]ExpectedCollateralMovement2
    - XpctdCollDueToB Expected Collateral Due To B [0..1]ExpectedCollateral2Choice (choice)
      Provides details about the type of collateral that will be either delivered to party B by party A or recalled to party B from party A.
      - XpctdCollDtls Expected Collateral Details [1..1]ExpectedCollateral2
      - SgrtdIndpdntAmt Segregated Independent Amount [1..1]ExpectedCollateralMovement2
  - 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.003 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.003 questions

What is the latest version of colr.003?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is colr.003.001.05.
What is the root element of colr.003?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.003.001.05, and its message element is MrgnCallReq (MarginCallRequest).
Is there an MT equivalent of colr.003?: Yes. colr.003 does the same business job as MT503. 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.