seev.038 Corporate Action Narrative

What seev.038 is for

seev.038 versions

Every version published in the e-Repository, newest first. Variant 001 and 002 are listed together: a variant other than 001 is a restricted form of the same message with its own schema.

seev.038 message structure

The building blocks of seev.038.001.09 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]
  • CorpActnNrrtv CorporateActionNarrative [1..1]
    • AcctDtls Account Details [0..1]AccountIdentification72Choice (choice)

      General information about the safekeeping account and the account owner.

      • ForAllAccts For All Accounts [1..1]AccountIdentification10

        All safekeeping accounts that own underlying financial instrument.

        • IdCd Identification Code [1..1]SafekeepingAccountIdentification1Code
      • AcctsListAndBalDtls Accounts List And Balance Details [1..*]AccountIdentification71

        Selected safekeeping accounts list (and optionally balance information) to which the corporate action event applies.

        • SfkpgAcct Safekeeping Account [0..1]Max35Text
        • BlckChainAdrOrWllt Block Chain Address Or Wallet [0..1]Max140Text
        • AcctOwnr Account Owner [0..1]PartyIdentification127Choice (choice)
        • SfkpgPlc Safekeeping Place [0..1]SafekeepingPlaceFormat42Choice (choice)
        • ConfdBal Confirmed Balance [1..1]BalanceFormat11Choice (choice)
    • UndrlygScty Underlying Security [0..1]SecurityIdentification19

      Provides information about the securitised right for entitlement.

      • ISIN ISIN [0..1]ISINOct2015Identifier

        International Securities Identification Number (ISIN).

      • OthrId Other Identification [0..*]OtherIdentification1

        Identification of a security by proprietary or domestic identification scheme.

        • Id Identification [1..1]Max35Text
        • Sfx Suffix [0..1]Max16Text
        • Tp Type [1..1]IdentificationSource3Choice (choice)
      • Desc Description [0..1]Max140Text

        Textual description of a security instrument.

    • CorpActnGnlInf Corporate Action General Information [1..1]CorporateActionGeneralInformation92

      General information about the corporate action event.

      • CorpActnEvtId Corporate Action Event Identification [1..1]Max35Text

        Reference assigned by the account servicer to unambiguously identify a corporate action event.

      • OffclCorpActnEvtId Official Corporate Action Event Identification [0..1]Max35Text

        Official and unique reference assigned by the official central body/entity within each market at the beginning of a corporate action event.

      • NrrtvTp Narrative Type [0..1]CorporateActionNarrative3Choice (choice)

        Specifies the type of narrative related to the message.

        • Cd Code [1..1]CorporateActionNarrative1Code
        • Prtry Proprietary [1..1]GenericIdentification30
    • AddtlInf Additional Information [1..*]Max8000Text

      Provides additional information.

    • 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 seev.038 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 seev.038

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

• ExternalFinancialInstrumentIdentificationType1Code24 codes

Related securities events messages

• seev.032Corporate Action Event Processing Status Advice
• seev.033Corporate Action Instruction
• seev.034Corporate Action Instruction Status Advice
• seev.035Corporate Action Movement Preliminary Advice
• seev.036Corporate Action Movement Confirmation
• seev.037Corporate Action Movement Reversal Advice
• seev.039Corporate Action Cancellation Advice
• seev.040Corporate Action Instruction Cancellation Request
• seev.041Corporate Action Instruction Cancellation Request Status Advice
• seev.042Corporate Action Instruction Statement Report

seev.039 is the Corporate Action Cancellation Advice, which pairs with an MT564 cancellation, not with the MT568.

seev.038 questions

What is the latest version of seev.038?

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

What is the root element of seev.038?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:seev.038.001.09, and its message element is CorpActnNrrtv (CorporateActionNarrative).

Is there an MT equivalent of seev.038?

Yes. seev.038 does the same business job as MT568. Field-level translation has gaps in both directions.