FireFly III icon

FireFly III

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

Actions89

Accounts API → List Accounts

AI-generated

Overview

This node operation lists accounts from the FireFly III API, allowing users to retrieve a filtered and paginated list of accounts. It supports filtering by account type and specifying a date to get the account balance on that day. This is useful for financial management workflows where users need to fetch account details, balances, and types for reporting or further processing.

Use Case Examples

  1. Retrieve all asset accounts with their balances as of a specific date.
  2. Fetch a paginated list of all accounts without any type filter.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Account Type Filter accounts by type, such as asset, cash, debt, revenue, etc.
Pagination Options Options to control pagination of the results, including limit (max number of results) and page number.
Account Balance Date A date formatted YYYY-MM-DD to show the account's balance on that specific day.

Output

JSON

  • json - The JSON response containing the list of accounts with their details and balances as per the applied filters and pagination.

Dependencies

  • FireFly III API with OAuth2 authentication

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to access account data.
  • Verify that the date format for Account Balance Date is YYYY-MM-DD to avoid request errors.
  • If pagination parameters are set, ensure the limit and page values are positive integers to prevent invalid requests.

Links

Discussion