Qonto icon

Qonto

Consume Qonto API

Actions46

Transaction → List Transactions

AI-generated

Overview

This node operation lists transactions from a specified bank account using the Qonto API. It supports identifying the account either by IBAN or internal bank account ID and allows filtering transactions based on various criteria such as date ranges, status, side (credit or debit), operation type, and presence of attachments or labels. It is useful for retrieving transaction data for accounting, auditing, or financial analysis purposes.

Use Case Examples

  1. Retrieve all transactions for a bank account identified by IBAN within a specific date range.
  2. Fetch a limited number of debit transactions with attachments from a bank account identified by its internal ID.

Properties

Name Meaning
Authentication Method of authentication to use for the API requests (Login and Secret-Key or OAuth2).
Return All Whether to return all transaction results or limit the number of results.
Limit Maximum number of transaction results to return when not returning all.
Identifier Type Type of identifier used to specify the bank account (IBAN or Bank Account ID).
IBAN The IBAN of the account to retrieve transactions from (required if Identifier Type is IBAN).
Bank Account ID The internal ID of the account to retrieve transactions from (required if Identifier Type is Bank Account ID).
Filters Optional filters to refine the list of transactions, including date ranges, status, side, operation type, labels, attachments, and whether to embed attachments or labels in the response.

Output

JSON

  • id - Unique identifier of the transaction.
  • amount - Amount of the transaction.
  • currency - Currency of the transaction amount.
  • status - Current status of the transaction.
  • emitted_at - Date and time when the transaction was emitted.
  • settled_at - Date and time when the transaction was settled.
  • side - Indicates if the transaction is a credit or debit.
  • operation_type - Type of operation for the transaction (e.g., card, transfer, income).
  • labels - Labels associated with the transaction, if requested.
  • attachments - Attachments associated with the transaction, if requested.

Dependencies

  • Qonto API

Troubleshooting

  • Ensure the correct authentication method is selected and credentials are valid to avoid authentication errors.
  • Verify that the IBAN or Bank Account ID provided is correct and exists in the Qonto account to prevent 'not found' errors.
  • Check filter parameters for correct date formats and allowed values to avoid request validation errors.
  • If 'Return All' is false, ensure the 'Limit' parameter is set to a positive integer to control the number of results.
  • Network issues or API rate limits may cause request failures; retry or check API usage limits.

Links

Discussion