FIfirefly-iii
currencies

List all accounts with this currency.

List all accounts with this currency.

get/v1/currencies/{code}/accounts

Request

  • Base URL
    https://demo.firefly-iii.org/api
  • URL
    https://demo.firefly-iii.org/api/v1/currencies/{code}/accounts
  • Auth
    • OAuth 2
      Authorization code: https://demo.firefly-iii.org/oauth/authorize
      Token URL: https://demo.firefly-iii.org/oauth/token
    • or HTTP bearer

Path parameters

codestring string required
Example:USD

The currency code.

Query parameters

limitinteger
Example:10

Number of items per page. The default pagination is per 50 items.

pageinteger
Example:1

Page number. The default pagination is per 50 items.

datestring date

A date formatted YYYY-MM-DD. When added to the request, Firefly III will show the account's balance on that day.

type'all' | 'asset' | 'cash' | 'expense' | 'revenue' | 'special' | 'hidden' | 'liability' | 'liabilities' | 'Default account' | 'Cash account' | 'Asset account' | 'Expense account' | 'Revenue account' | 'Initial balance account' | 'Beneficiary account' | 'Import account' | 'Reconciliation account' | 'Loan' | 'Debt' | 'Mortgage'

Optional filter on the account type(s) returned

Headers

X-Trace-Idstring uuid
Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Response

A list of accounts

Example response

{
  "data": [
    {
      "type": "accounts",
      "id": "2",
      "attributes": {
        "created_at": "2026-02-01T00:00:00+00:00",
        "updated_at": "2026-02-01T00:00:00+00:00",
        "order": 1,
        "name": "My checking account",
        "type": "asset",
        "account_role": "defaultAsset",
        "object_group_id": "5",
        "object_group_order": 5,
        "object_group_title": "Example Group",
        "object_has_currency_setting": true,
        "currency_id": "5",
        "currency_name": "Euro",
        "currency_code": "EUR",
        "currency_symbol": "$",
        "currency_decimal_places": 2,
        "primary_currency_id": "5",
        "primary_currency_name": "Euro",
        "primary_currency_code": "EUR",
        "primary_currency_symbol": "$",
        "primary_currency_decimal_places": 2,
        "current_balance": "123.45",
        "pc_current_balance": "123.45",
        "balance_difference": "123.45",
        "pc_balance_difference": "123.45",
        "opening_balance": "-1012.12",
        "pc_opening_balance": "-1012.12",
        "virtual_balance": "123.45",
        "pc_virtual_balance": "123.45",
        "debt_amount": "1012.12",
        "pc_debt_amount": "1012.12",
        "current_balance_date": "2026-02-28T23:59:59+00:00",
        "notes": "Some example notes",
        "monthly_payment_date": "2026-02-01T00:00:00+00:00",
        "credit_card_type": "monthlyFull",
        "account_number": "7009312345678",
        "iban": "GB98MIDL07009312345678",
        "bic": "BOFAUS3N",
        "opening_balance_date": "2026-02-01T00:00:00+00:00",
        "liability_type": "loan",
        "liability_direction": "credit",
        "interest": "5.3",
        "interest_period": "monthly",
        "include_net_worth": true,
        "longitude": 5.916667,
        "latitude": 51.983333,
        "zoom_level": 6,
        "last_activity": "2026-02-01T00:00:00+00:00"
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 3,
      "count": 20,
      "per_page": 100,
      "current_page": 1,
      "total_pages": 1
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.