FIfirefly-iii
accounts

Get single account.

Returns a single account by its ID.

get/v1/accounts/{id}

Request

  • Base URL
    https://demo.firefly-iii.org/api
  • URL
    https://demo.firefly-iii.org/api/v1/accounts/{id}
  • 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

idstring required
Example:123

The ID of the account.

Query parameters

startstring date

A date formatted YYYY-MM-DD. May be omitted.

endstring date

A date formatted YYYY-MM-DD. Must be after "start". Can not be the same as "start". May be omitted.

datestring date

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

Headers

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

Unique identifier associated with this request.

Response

The requested account

Example response

{
  "data": {
    "type": "accounts",
    "id": "2",
    "attributes": {
      "created_at": "2025-12-01T00:00:00+00:00",
      "updated_at": "2025-12-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": "2025-12-31T23:59:59+00:00",
      "notes": "Some example notes",
      "monthly_payment_date": "2025-12-01T00:00:00+00:00",
      "credit_card_type": "monthlyFull",
      "account_number": "7009312345678",
      "iban": "GB98MIDL07009312345678",
      "bic": "BOFAUS3N",
      "opening_balance_date": "2025-12-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": "2025-12-01T00:00:00+00:00"
    }
  }
}

Changes

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