FireFly III icon

FireFly III

Read, update, write and delete data using the powerful FireFly III API

Actions89

Transactions API → List Transactions

AI-generated

Overview

This node operation lists transactions from the FireFly III API. It allows users to retrieve a filtered and paginated list of financial transactions, which can be useful for financial reporting, auditing, or integration with other financial tools. Users can filter transactions by type (e.g., withdrawal, deposit, transfer, opening balance), specify a custom transaction type, and define a date range for the transactions. Pagination options such as limit and page number help manage large datasets.

Use Case Examples

  1. Retrieve all deposit transactions between 2023-01-01 and 2023-01-31, limited to 100 results per page.
  2. List all transactions of type 'transfer' on page 2 with 50 results per page.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Transaction Filters Filters to narrow down the list of transactions based on type, custom type, and date range.
Pagination Options Options to control the number of results returned and the page number for pagination.

Output

JSON

  • json - The JSON response containing the list of transactions matching the specified filters and pagination options.

Dependencies

  • Requires an API key credential for FireFly III OAuth2 authentication to access the FireFly III API.

Troubleshooting

  • Ensure the API credentials are correctly configured and valid to avoid authentication errors.
  • Verify that the date filters are in the correct YYYY-MM-DD format to prevent request failures.
  • If no transactions are returned, check that the filters are not too restrictive or that transactions exist for the specified criteria.
  • Pagination parameters should be positive integers; otherwise, the API may return errors or unexpected results.

Links

Discussion