AqBanking

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

Actions8

Account → Get Balance

AI-generated

Overview

This node interacts with German banks using the AqBanking software to retrieve the current balance of a specified bank account. It supports querying by account number or IBAN and can handle different AqBanking implementations (native, Python, Docker, or system CLI). This node is useful for financial automation workflows where real-time account balance information is needed, such as personal finance management, accounting automation, or bank reconciliation processes.

Use Case Examples

  1. Retrieve the balance of a checking account using its IBAN to monitor available funds.
  2. Automate balance checks for multiple accounts to trigger alerts when funds fall below a threshold.

Properties

Name Meaning
Account Number/IBAN The bank account number or IBAN to query for the balance.
Bank Code (BLZ) Bank code (BLZ), required only if using account number instead of IBAN.
Additional Options Optional settings including whether to simplify the output, include raw AqBanking output, and limit the number of results.

Output

JSON

  • balance - The current balance amount of the bank account.
  • currency - The currency of the balance amount.
  • accountNumber - The queried bank account number or IBAN.
  • bankCode - The bank code (BLZ) used in the query, if provided.
  • timestamp - The timestamp when the balance 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 the balance cannot be parsed from the AqBanking output, an error is thrown indicating parsing failure.
  • Errors from the underlying AqBanking CLI or native client are propagated and should be checked for correct configuration and credentials.

Links

Discussion