Qonto icon

Qonto

Interact with Qonto API

Actions45

Overview

The node interacts with the Qonto API to retrieve multiple SEPA transfer records. Specifically, the "Get Many" operation under the "SEPA Transfer" resource fetches a list of SEPA transfers based on user-defined filters and pagination options.

This node is useful for financial automation workflows where users need to monitor, report, or process batches of SEPA transfers from their Qonto account. For example, it can be used to:

  • Retrieve all pending SEPA transfers for reconciliation.
  • Fetch transfers updated within a specific date range for auditing.
  • Paginate through large sets of SEPA transfers to integrate with accounting systems.

Properties

Name Meaning
Authentication Method of authentication; currently supports "API Key".
Return All Whether to return all matching SEPA transfers or limit the number of results.
Limit Maximum number of SEPA transfers to return when "Return All" is false (default 100, max 100).
Page Page number to retrieve when paginating results (starts at 1).
Filters Collection of optional filters to narrow down the SEPA transfers:
- Status Filter by one or more statuses: Pending, Processing, Canceled, Declined, Settled.
- Beneficiary IDs Comma-separated list of beneficiary IDs to filter transfers by specific beneficiaries.
- Updated From Minimum update timestamp to filter transfers updated after this date/time.
- Updated To Maximum update timestamp to filter transfers updated before this date/time.
- Scheduled Date From Minimum scheduled date to filter transfers scheduled after this date/time.
- Scheduled Date To Maximum scheduled date to filter transfers scheduled before this date/time.

Output

The node outputs an array of JSON objects representing SEPA transfer records. Each object contains details about a single SEPA transfer as returned by the Qonto API, including fields such as status, beneficiary information, timestamps, and amounts.

If binary data were involved (e.g., documents or attachments), it would be included in a separate binary property, but for this operation, the output is purely JSON data describing SEPA transfers.

Dependencies

  • Requires an API key credential for authenticating requests to the Qonto API.
  • The node uses the Qonto API endpoints, which may require network access and proper API permissions.
  • No additional environment variables are explicitly required beyond the API key configuration.

Troubleshooting

  • Common Issues:
    • Invalid or missing API key will cause authentication failures.
    • Requesting pages beyond available data may return empty results.
    • Using invalid filter values (e.g., incorrect status names) may result in errors or no data.
  • Error Messages:
    • Errors related to unknown resources or operations indicate misconfiguration of the node parameters.
    • API rate limits or network issues may cause request timeouts or failures.
  • Resolutions:
    • Verify that the API key is correctly configured and has necessary permissions.
    • Ensure filter values conform to allowed options.
    • Use pagination parameters within valid ranges.
    • Check network connectivity and Qonto service status if requests fail repeatedly.

Links and References

Discussion