FireFly III icon

FireFly III

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

Actions89

Categories API → Get Transactions by Category

AI-generated

Overview

This node operation retrieves transactions associated with a specific category from the FireFly III API. It allows filtering transactions by date range and supports pagination to manage large result sets. This is useful for users who want to analyze or report on financial transactions grouped by category, such as expenses or income categories.

Use Case Examples

  1. Fetch all transactions for a given category within a specific date range to analyze spending habits.
  2. Paginate through transactions of a category to generate detailed financial reports.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Category ID The ID of the category for which transactions are to be retrieved.
Date Range Filters Filters to specify the start and end dates (YYYY-MM-DD) to limit the transactions retrieved within this date range.
Pagination Options Options to control the number of results returned and the page number for paginated results.

Output

JSON

  • json - The JSON response containing the list of transactions for the specified category, filtered by date range and paginated as requested.

Dependencies

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

Troubleshooting

  • Ensure the Category ID is valid and exists in the FireFly III system; otherwise, the API will return an error.
  • Check that the date range filters are in the correct YYYY-MM-DD format to avoid request failures.
  • Pagination parameters should be positive integers; invalid values may cause errors or unexpected results.
  • If the X-Trace-ID is used, ensure it is a valid UUID to assist with debugging and tracing requests.

Links

Discussion