bunq icon

bunq

Interact with bunq banking API
Join our community

Actions42

Overview

This node operation allows you to create an account statement export from a specified monetary account within a given date range. It interacts with the bunq banking API to generate statements in various formats such as CSV, PDF, MT940, or CAMT053. This is useful for automating financial reporting, bookkeeping, or integrating bank statement data into other systems.

Common scenarios:

  • Automatically generating monthly bank statements for accounting purposes.
  • Exporting transaction history in a specific format required by financial software.
  • Archiving statements in different regional date formats and languages.
  • Including attachments and balance information in exported statements for detailed records.

Example use case:
You want to generate a PDF bank statement for your business account covering the last quarter, including all transaction attachments and balances, formatted in US date style and English language. This node operation can automate that export and provide the statement ready for download or further processing.

Properties

Name Meaning
User ID The ID of the user. Leave empty to use the current authenticated user.
Account ID The ID of the monetary account to export the statement from. (Required)
Statement Format The format of the statement export. Options: CSV, PDF, MT940 (SWIFT bank statement), CAMT053 (ISO 20022). (Required)
Date From Start date for the statement period. (Required)
Date To End date for the statement period. (Required)
Additional Options Collection of optional settings:
- Include Attachments Boolean flag to include transaction attachments in the export.
- Regional Format Date format used in the export. Options: European (DD/MM/YYYY), US (MM/DD/YYYY), ISO (YYYY-MM-DD).
- Include Balance Boolean flag to include balance information in the statement.
- Language Language for the statement export. Options: English, Dutch, German, French.

Output

The output JSON contains the response from the bunq API after creating the statement export request. It includes details such as:

  • Statement ID
  • Statement format
  • Status of the export request
  • Download URL (if available)
  • Other metadata related to the export

If the statement is downloaded (via a separate operation), the node outputs binary data representing the actual statement file, along with metadata like file name, content type, and file size.

Dependencies

  • Requires access to the bunq banking API via an API key or OAuth2 token configured in n8n credentials.
  • Proper permissions on the specified user and monetary account to request statement exports.
  • Network connectivity to bunq API endpoints.

Troubleshooting

  • Statement not ready for download:
    Error message: Statement {id} is not ready for download. Status: {status}
    This means the export process is still running or failed. Wait and retry later or check the status before downloading.

  • Statement not found:
    Error message: Statement {id} not found
    Verify the statement ID is correct and belongs to the specified account.

  • Missing required parameters:
    Ensure Account ID, Statement Format, Date From, and Date To are provided and valid.

  • API authentication errors:
    Check that the API credentials are correctly set up and have sufficient permissions.

Links and References

Discussion