FireFly III icon

FireFly III

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

Actions89

Budgets API → Get Limit Transactions

AI-generated

Overview

This node operation retrieves transactions associated with a specific budget limit in the FireFly III budgeting system. It allows users to specify the budget ID and the budget limit ID to fetch transactions related to that limit. Additionally, users can apply pagination options, date range filters, and filter transactions by type (all, withdrawal, deposit, transfer). This operation is useful for financial analysis, auditing, or tracking spending within defined budget limits.

Use Case Examples

  1. Fetch all transactions for a given budget limit to review spending patterns.
  2. Retrieve deposit transactions within a specific date range for a budget limit to analyze income sources.
  3. Paginate through transactions of a budget limit to process large datasets in manageable chunks.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Budget ID The ID of the budget to which the budget limit belongs.
Budget Limit ID The ID of the budget limit associated with the budget.
Date Range Filters Optional start and end dates to filter transactions within a specific date range.
Pagination Options Options to control the number of results returned and the page number.
Transaction Type Filter transactions by type: all, withdrawal, deposit, or transfer.

Output

JSON

  • json - The JSON response containing the list of transactions for the specified budget limit, including transaction details as provided by the FireFly III API.

Dependencies

  • FireFly III API with OAuth2 authentication

Troubleshooting

  • Ensure that both Budget ID and Budget Limit ID are provided and valid; missing or incorrect IDs will cause the request to fail.
  • Verify that the date range filters, if used, are in the correct YYYY-MM-DD format.
  • Check API credentials and permissions to ensure access to budget and transaction data.
  • If pagination is used, ensure the limit and page values are positive integers to avoid errors.

Links

Discussion