# Digital Twin — Data Dictionary

Integrating

# Data dictionary
The data elements exchanged with Digital Twin over AVRO / Kafka messages and REST APIs. The name, type, and maximum size of each field below are the contract — build your payloads within them and your data will be accepted end-to-end across every part of the platform.

Sizes are maximums. Stay within them: a value that respects the size and type here is guaranteed to fit. Strings are UTF-8; integer means a whole number; enum accepts only the listed values.

Message envelope (events)

FieldTypeMaxRequiredNotes

sourcestring—yesOriginating system id (e.g. core-banking-system)
eventIdstring (UUID)36yesUsed for idempotency; UUID v4
createdAtUtcinteger (epoch millis)—yesUTC milliseconds; timestamps are timezone-less

Account

FieldTypeMaxRequiredNotes

account.branchinteger—yesBranch number
account.accountinteger—yesAccount number
accountTypestring15yesMust match a known account type
timeZonestring30yesIANA name (e.g. America/Chicago)
activeboolean—yesAccount active flag

Account type

FieldTypeMaxRequiredNotes

accountType.keystring15yesUnique account-type identifier
categoryTypestring64yese.g. DEMAND_DEPOSIT, SAVINGS
descriptionstring100yesFree text; must not contain personal data

History code (transaction code)

FieldTypeMaxRequiredNotes

historyCodeIdinteger—yesNumeric transaction code (e.g. 3359)
typeenum—yesCREDIT · DEBIT · BALANCE
descriptionstring50yesFree text; must not contain personal data

Features (account, account type, history code, membership)

FieldTypeMaxRequiredNotes

feature.namestring64yese.g. BLOCKED_FOR_CREDIT
feature.value.typeenum—yesBOOLEAN · STRING · DECIMAL · DATE · DATE_RANGE
feature.value.stringValuestring1024conditionalWhen type = STRING

Membership / account holder

FieldTypeMaxRequiredNotes

clientIdstring64yesStable hash identifying the client (≤ 64 chars); never the raw tax id
kindstring255yesMembership kind label (e.g. PERSON_HOLDER_TAX_ID)

Hold reason / domain items

FieldTypeMaxRequiredNotes

itemIdstring64yesNatural key of the item (e.g. hold-reason key)
itemDescriptionstring255yesFree text; must not contain personal data

These field specs apply to both the AVRO message payloads and the REST request bodies — see REST APIs and AVRO / Kafka messages for the full operations. Machine-readable docs for AI agents: llms.txt.

← Security & access
REST APIs →