ZagTrader

caad: Card Administration

caad.010 Custom Report

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

caad.010 is the ISO 20022 CustomReport message in the Card Administration business area (caad). The latest version is caad.010.001.02, and 2 versions are in the repository.

Message
CustomReport
Latest version
caad.010.001.02
Submitting organisation
ISO TC68/SC9/TG1
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What caad.010 is for

The Custom Report message can be initiated by any party and received by any party (acquirer, agent, issuer or other party) connected to a network.

This message provides the capability to convey customized reports that are defined by bi-lateral agreement.

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

caad.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.

VersionRegistration statusPublished in
caad.010.001.02latestRegisteredLatest version set
caad.010.001.01RegisteredPrevious version set

caad.010 message structure

The building blocks of caad.010.001.02 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]
    • CstmRpt CustomReport [1..1]
      • Hdr Header [1..1]Header71

        Information related to protocol management.

        • MsgFctn Message Function [1..1]ExternalMessageFunction1Code

          Identifies the type of process related to the message.

        • PrtcolVrsn Protocol Version [1..1]Max2048Text

          Version of the acquirer to issuer protocol specifications.

        • XchgId Exchange Identification [0..1]Max35Text

          Unique identification of an exchange of messages between two parties.

        • ReTrnsmssnCntr Re Transmission Counter [0..1]Max3NumericText

          Number of retransmission of the message.

        • CreDtTm Creation Date Time [1..1]ISODateTime

          Date and time at which the message was sent.

        • BtchMgmtInf Batch Management Information [0..1]BatchManagementInformation1

          Information related to the batch and the collection to which the message belongs if any.

          • ColltnId Collection Identification [0..1]Max35Text
          • BtchId Batch Identification [1..1]Max35Text
          • MsgSeqNb Message Sequence Number [0..1]Max15NumericText
          • MsgChcksmInptVal Message Checksum Input Value [0..1]Max140Binary
        • InitgPty Initiating Party [1..1]GenericIdentification183

          Unique identification of the partner that has initiated the exchange.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
        • RcptPty Recipient Party [0..1]GenericIdentification183

          Unique identification of the partner that is the recipient of the message exchange.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
        • TracData Trace Data [0..*]AdditionalData1

          Information sent in the request message to be returned in the response one, for instance to help in the retrieval of the context of the exchange.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • Tracblt Traceability [0..*]Traceability10

          Identification of partners involved in exchange from the merchant to the issuer, with the relative timestamp of their exchanges.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
          • DtTmIn Date Time In [0..1]ISODateTime
          • DtTmOut Date Time Out [0..1]ISODateTime
      • Orgtr Originator [0..1]PartyIdentification286

        Identifies the originator of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Sndr Sender [0..1]PartyIdentification286

        Party sending the message to another intermediary agent or to the final destination.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Rcvr Receiver [0..1]PartyIdentification286

        Party receiving the message from the origin or from an intermediary agent.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Dstn Destination [0..1]PartyIdentification286

        Identifies the destination of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Prgrmm Programme [0..*]ProgrammeMode5

        Programme, network, or brand processes the transaction.

        • ApldId Applied Identification [1..1]Max35Text

          Identification of the programme, network, or brand applied to the transaction.

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the program, network, or brand processed the transaction.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • Jursdctn Jurisdiction [0..1]Jurisdiction2

        Contains information that identifies or is specific to a transaction jurisdiction.

        • DmstInd Domestic Indicator [0..1]TrueFalseIndicator

          When true, indicates the transaction is considered to be domestic.

        • DmstQlfctn Domestic Qualification [0..1]Max35Text

          Identifies the reason the transaction is considered to be domestic or non-domestic.

      • SttlmSvc Settlement Service [0..1]SettlementService6

        Type of settlement service for specific services requiring settlement.

        • Tp Type [0..1]Max35Text

          Type of settlement service applied

        • Id Identification [0..1]Max35Text

          Identification of settlement service applied.

        • ReqdDt Requested Date [0..1]ISODate

          Date requested for settlement.

        • Dfrrd Deferred [0..1]TrueFalseIndicator

          Indicate a deferred Settlement date.

        • Dt Date [0..1]ISODate

          Actual date of settlement.

        • Tm Time [0..1]ISOTime

          Actual time of settlement.

        • Prd Period [0..1]Max35Text

          Identifies the settlement period, cycle or group.

        • CutOffTm Cut Off Time [0..1]ISODateTime

          Identifies the effective end time of the settlement date and/or period.

        • RptgNttyTp Reporting Entity Type [0..1]Max35Text

          Identifies the type of settlement reporting entity

        • RptgNttyId Reporting Entity Identification [0..1]Max35Text

          Identification of the settlement reporting entity.

        • AddtlInf Additional Information [0..*]AdditionalData1

          Additional Settlement Information.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • Rcncltn Reconciliation [0..1]Reconciliation4

        Identification of the reconciliation period between the acquirer and the issuer or their respective agents.

        • Id Identification [0..1]Max35Text

          Identification of the reconciliation.

        • Dt Date [0..1]ISODate

          Date of the reconciliation.

        • ChckptRef Checkpoint Reference [0..1]Max35Text

          A value used to allow a period within a reconciliation date.

      • Crrctn Correction [0..1]CorrectionIdentification1

        Identifies that is a corrected version of a report that was previously sent.

        • Ind Indicator [0..1]TrueFalseIndicator

          Indicates the message contains an updated version of a message that was previously sent.

        • Dt Date [0..1]ISODate

          Contains the date of the update.

        • Tm Time [0..1]ISOTime

          Contains the time of the update.

      • Rpt Report [1..1]ReportData7

        Specifies the attributes of a report and its content.

        • Nm Name [0..1]Max140Text

          Name of the report.

        • Id Identification [0..1]Max140Text

          Report identification.

        • Qlfr Qualifier [0..1]Max70Text

          Additional specific information to ID (Country, Service, etc.)

        • Dt Date [0..1]ISODate

          Date of the report.

        • Tm Time [0..1]ISOTime

          Time of the report.

        • Seq Sequence [0..1]Max5NumericText

          Contains the specific instance of the report (e.g., sequence “2” of the report within a specific time frame).

        • TtlOcrncs Total Occurrences [0..1]Max5NumericText

          Contains the expected total number of occurrences of the report within a specific time frame.

        • Frqcy Frequency [0..1]Frequency17Code

          Report frequency.

        • ConttnInd Continuation Indicator [0..1]TrueFalseIndicator

          Indicates that report is not complete.

        • AddtlData Additional Data [0..*]AdditionalData1

          Additional report attributes or information.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • Frmt Format [0..1]OutputFormat5Code

          Report format.

        • OthrFrmt Other Format [0..1]Max35Text

          Other report format defined by national organization or by bi-lateral agreement.

      • RptCntt Report Content [0..*]ReportContent2

        Contains the content of a report.

        • RptLineSeq Report Line Sequence [0..1]Max10NumericText

          Sequence number of the report line in the report.

        • FrmtdCntt Formatted Content [1..1]ReportContent2Choice (choice)

          Formatted or unformatted report content.

          • Txt Text [1..1]Max10MbText
          • Binry Binary [1..1]Max20MbBinary
          • PrtctdData Protected Data [1..1]ProtectedData2
      • AddtlData Additional Data [0..*]AdditionalData2

        Additional report attributes or information.

        • Tp Type [0..1]Max35Text

          Type of information.

        • Dtls Details [0..*]AdditionalData1

          Detail of the specific type of data.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information that can not be captured in the structured fields and/or 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.

      • SctyTrlr Security Trailer [0..1]ContentInformationType41

        Trailer of the message containing a MAC

        • MACData MAC Data [1..1]MACData1

          Type of data protection.

          • Ctrl Control [1..1]Exact1HexBinaryText
          • KeySetIdr Key Set Identifier [1..1]Max8NumericText
          • DrvdInf Derived Information [0..1]Max32HexBinaryText
          • Algo Algorithm [1..1]Max2NumericText
          • KeyLngth Key Length [0..1]Max4NumericText
          • KeyPrtcn Key Protection [0..1]Max2NumericText
          • KeyIndx Key Index [0..1]Max5NumericText
          • PddgMtd Padding Method [0..1]Max2NumericText
          • InitlstnVctr Initialisation Vector [0..1]Max32HexBinaryText
        • MAC MAC [1..1]Max8HexBinaryText

          Message Authentication Code data.

Have a caad.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 caad.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.

caad.010 questions

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