FireFly III icon

FireFly III

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

Actions89

Tags API → Get Transactions by Tag

AI-generated

Overview

This node operation retrieves transactions associated with a specific tag from the FireFly III API. It is useful for users who want to filter and analyze financial transactions based on tags they have assigned, such as categorizing expenses or income by project, event, or any custom label. For example, a user can fetch all transactions tagged with "Travel" within a certain date range and paginate through the results.

Use Case Examples

  1. Fetch all transactions tagged with 'Groceries' for the last month to analyze spending patterns.
  2. Retrieve transactions tagged with 'Business' to prepare expense reports for tax purposes.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Target Tag Name/ID The name or ID of the tag to filter transactions by. This is used in the API path to specify which tag's transactions to retrieve.
Pagination Options Options to control the number of results returned and the page number for paginated responses.
Date Range Filters Filters to limit transactions to those within a specified start and end date.

Output

JSON

  • json - The JSON response containing the list of transactions associated with the specified tag, including pagination and date filtering if applied.

Dependencies

  • Requires an API key credential for FireFly III API authentication.

Troubleshooting

  • Ensure the 'Target Tag Name/ID' is correctly specified; using tags with international (non-ASCII) characters may cause issues.
  • Verify that pagination parameters are valid numbers and within acceptable ranges.
  • Check that date filters are in the correct YYYY-MM-DD format.
  • Common errors include 404 if the tag does not exist, or 400 if query parameters are malformed. Verify inputs accordingly.

Links

Discussion