Attributes
AccountIds
List of finAPI account IDs associated with this bank connection
Data Type
INT_ARRAY
AccountNumber
Bank-specific account number
Data Type
STRING
Amount
Transaction amount (positive for credit, negative for debit)
Data Type
DOUBLE
AvailableFunds
Available funds on the account
Data Type
DOUBLE
Balance
Current balance of the account
Data Type
DOUBLE
BalanceDate
Date of the last balance update
Data Type
DATE_TIME
BankAccountClosedAt
Date the account was closed at the bank. Set by the user; a closed account keeps its transactions and matches but is no longer synchronized and raises no warnings. Empty while the account is open
Data Type
DATE_TIME
BankAccountExternalId
Identifier of the account in the external system (e.g. finAPI account ID)
Data Type
STRING
BankAccountType
Type of the bank account
Data Type
ENUM: Basic.Accounting/BankAccountType
BankCode
National bank code (e.g. BLZ in Germany/Austria) or finAPI bank ID
Data Type
STRING
BankConnectionExternalId
Identifier of the bank connection in the external system
Data Type
STRING
BankTransactionCode
Bank transaction code classifying the transaction type
Data Type
STRING
Bic
Bank Identifier Code (BIC/SWIFT)
Data Type
STRING
BookingDate
Date when the transaction was booked
Data Type
DATE_TIME
ConsentExpiresAt
Expiry of the bank's AIS consent; after this date a re-consent (web form) is required before further synchronization
Data Type
DATE_TIME
CounterpartBic
BIC/SWIFT code of the counterpart's bank
Data Type
STRING
CounterpartIban
IBAN of the counterpart
Data Type
STRING
CounterpartName
Name of the counterpart (sender or receiver)
Data Type
STRING
CreditorId
SEPA creditor identifier for direct debits
Data Type
STRING
Currency
ISO 4217 currency code (e.g. EUR, USD)
Data Type
STRING
EndToEndReference
End-to-end reference of the transaction
Data Type
STRING
ExecutionDate
Requested execution date of the payment
Data Type
DATE_TIME
LastSuccessfulSync
Timestamp of the last successful synchronization
Data Type
DATE_TIME
LastSyncAttemptAt
Time of the last attempt to refresh the connection at the bank data provider, successful or not (LastSuccessfulSync keeps the time of the last success)
Data Type
DATE_TIME
LastSyncAttemptResult
Outcome of the last refresh attempt: COMPLETED, WEB_FORM_REQUIRED (the bank asks for a login), COMPLETED_WITH_ERROR or TIMEOUT
Data Type
STRING
MandateReference
SEPA mandate reference for direct debits
Data Type
STRING
Overdraft
Overdraft limit of the account
Data Type
DOUBLE
PaymentAmount
Amount to transfer
Data Type
DOUBLE
PaymentCurrency
ISO 4217 currency code of the payment
Data Type
STRING
PaymentEndToEndReference
End-to-end reference for the payment
Data Type
STRING
PaymentExternalId
Identifier of the payment in the external system
Data Type
STRING
PaymentOrderStatus
Current status of the payment order
Data Type
ENUM: Basic.Accounting/PaymentOrderStatus
PaymentPurpose
Purpose or reference text of the payment
Data Type
STRING
PaymentReference
Payment reference of the transaction
Data Type
STRING
Purpose
Purpose or reference text of the transaction
Data Type
STRING
RecipientBic
BIC/SWIFT code of the recipient's bank
Data Type
STRING
RecipientIban
IBAN of the payment recipient
Data Type
STRING
RecipientName
Name of the payment recipient
Data Type
STRING
SettlementCreditorId
Credit card accounts only: SEPA creditor identifier the card issuer uses to collect the monthly settlement from another own account (e.g. AT..ZZZ...). A debit with this creditor id is a transfer between own accounts. Empty = not used for recognition
Data Type
STRING
SettlementMandateReference
Credit card accounts only: SEPA mandate reference of the settlement direct debit. A debit with this mandate reference is a transfer between own accounts. Empty = not used for recognition
Data Type
STRING
SettlementNamePattern
Credit card accounts only: case-insensitive text that the counterpart name or the purpose of the settlement debit contains (e.g. PAYLIFE). Fallback when the import carries no creditor id or mandate reference. Empty = not used for recognition
Data Type
STRING
SyncStatus
Current synchronization status
Data Type
STRING
SyncStatusDetail
Plain-text detail behind SyncStatusReason as reported by the bank data provider (update result and error message). Never contains tokens or credentials. Empty while the connection is healthy
Data Type
STRING
SyncStatusInterface
Banking interface the sync status was judged on (XS2A, FINTS_SERVER, WEB_SCRAPER): the interface that most recently delivered data
Data Type
STRING
SyncStatusReason
Stable code that says why SyncStatus is not Connected (UserActionRequired, ConsentExpired, ConsentMissing, UpdateFailed, NoRecentUpdate, NeverUpdated, NoInterface). Empty while the connection is healthy. Written by the finAPI sync; clients map the code to text
Data Type
STRING
TransactionAccountServicerReference
The bank's own booking reference of the entry (camt.053 AcctSvcrRef); together with the account's IBAN the stable deduplication key for statement imports
Data Type
STRING
TransactionBookingStatus
Booking status of the entry as reported by the bank (Booked or Pending)
Data Type
ENUM: Basic.Accounting/TransactionBookingStatus
TransactionCardTransactionDate
Date the card purchase happened, as printed in the purpose line of card bookings (the booking date is days later); persisted by the importers so the matcher can use it as a key instead of re-parsing the purpose
Data Type
DATE_TIME
TransactionClarificationNote
Free-text note describing what needs to be clarified about the transaction.
Data Type
STRING
TransactionCurrency
ISO 4217 currency code of the transaction
Data Type
STRING
TransactionDirection
Direction of the transaction (Credit or Debit)
Data Type
ENUM: Basic.Accounting/TransactionDirection
TransactionExclusionReason
Why an Ignored transaction is excluded from matching and category analysis (only meaningful when MatchState = Ignored)
Data Type
ENUM: Basic.Accounting/TransactionExclusionReason
TransactionId
Unique identifier of the transaction from the source system
Data Type
STRING
TransactionInClarification
Marks the transaction as under clarification (open question / needs review). Orthogonal to the reconciliation MatchState; used to surface open clarification cases in an overview and list filter.
Data Type
BOOLEAN
TransactionMatchComment
Comment on the reconciliation state, e.g. why a transaction is ignored
Data Type
STRING
TransactionMatchState
Reconciliation state of the transaction against accounting documents
Data Type
ENUM: Basic.Accounting/TransactionMatchState
TransactionStatementReference
Identifier of the bank statement the entry came from (camt.053 Stmt/Id, plus the legal sequence number where the bank provides one, e.g. 2026-00042); used for completeness checks over the statement chain
Data Type
STRING
TransactionText
Descriptive text of the transaction from the bank statement
Data Type
STRING
ValueDate
Value date of the transaction
Data Type
DATE_TIME