Zum Hauptinhalt springen

Attributes

Version: 1.14.0

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