AqBanking

Interact with German banks using AqBanking (FinTS/HBCI protocol)

Actions8

Transaction → Get Transactions

AI-generated

Overview

This node operation retrieves the transaction history for a specified bank account using the AqBanking interface, which supports the FinTS/HBCI protocol commonly used by German banks. It allows users to specify the account by account number or IBAN, optionally include the bank code (BLZ), and define a date range for the transactions to be fetched. Additional options include simplifying the output format, including raw output data, and limiting the number of results. This operation is useful for financial data analysis, bookkeeping, or integrating bank transaction data into workflows.

Use Case Examples

  1. A user wants to fetch the last 30 days of transactions from their German bank account using their IBAN.
  2. A business needs to retrieve all transactions within a custom date range for accounting purposes.
  3. An automation workflow exports recent transactions for reconciliation and reporting.

Properties

Name Meaning
Account Number/IBAN The bank account number or IBAN to query for transactions.
Bank Code (BLZ) Bank code (BLZ), required only if using account number instead of IBAN.
Date Range The date range for which to retrieve transactions, with options like all available, last 30 days, last 90 days, or a custom range.
Start Date The start date for the transaction query, used only if Date Range is set to Custom Range.
End Date The end date for the transaction query, used only if Date Range is set to Custom Range.
Additional Options Additional settings such as simplifying output, including raw AqBanking output, and limiting the maximum number of results.

Output

JSON

  • transactions - Array of transaction objects including details like amount, currency, date, remote name, purpose, remote IBAN, remote BIC, and transaction code.
  • count - The count of transactions returned.
  • accountNumber - The queried account number or IBAN.
  • bankCode - The bank code (BLZ) used for the query, if provided.
  • dateRange
    • startDate - The start date of the transaction query range.
    • endDate - The end date of the transaction query range.
  • timestamp - Timestamp when the data was retrieved.
  • rawOutput - Optional raw output from AqBanking if requested in additional options.

Dependencies

  • Requires AqBanking credentials for authentication with the bank.

Troubleshooting

  • Ensure the account number or IBAN is provided; otherwise, the node throws an error indicating the account number is required.
  • If using account number instead of IBAN, the bank code (BLZ) may be required for the query to succeed.
  • Errors related to AqBanking CLI execution or native FinTS client failures may occur; enabling debug logging can help diagnose issues.
  • If the output cannot be parsed correctly, the node throws an error indicating parsing failure, which may require checking the bank's response format or node configuration.

Discussion