Skip to main content
This page covers fields specific to Midaz ledger operations, including balances, transaction routes, operation routes, and metadata indexes.

1. Balances


FieldDescriptionUsed in
keyUnique identifier for the balance within the account contextMidaz
availableAmount available for transactionsMidaz
onHoldAmount currently reserved or on holdMidaz
versionBalance version, updated with each transaction (for optimistic concurrency)Midaz
accountTypeType of account that holds this balanceMidaz
allowSendingWhether the balance can be used to send transactionsMidaz
allowReceivingWhether the balance can be used to receive transactionsMidaz
assetCodeAsset or currency code (ISO 4217, 3 characters)Midaz
aliasAccount alias for quick identificationMidaz

2. Transaction routes


FieldDescriptionUsed in
titleShort text summarizing the route’s purpose (max 50 characters)Midaz
descriptionDetailed description of the transaction route (max 250 characters)Midaz
operationRoutesArray of operation route IDs that define source and destination logicMidaz

3. Operation routes


FieldDescriptionUsed in
operationTypeRoute direction: source or destinationMidaz
codeExternal reference code for the operation routeMidaz
accountAccount selection rule for the operationMidaz
ruleTypeAccount selection method: alias or account_typeMidaz
validIfCondition that must be satisfied for the rule to matchMidaz

4. Metadata indexes


FieldDescriptionUsed in
metadataKeyMetadata key to index (max 100 characters, must match the field name in entities)Midaz
uniqueWhether the index enforces uniqueness (duplicate values rejected when true)Midaz
sparseWhether the index is sparse (only indexes entities containing the field)Midaz
indexNameName of the created indexMidaz
entityNameName of the entity collection the index applies toMidaz