Skip to main content
Accounts hold transactions and balances. Accounts created through the API are always manual (unlinked) accounts; accounts connected to a bank feed appear with "linked": true and cannot be created or deleted via the API.

​
The account object

{
  "id": "k4859a...",
  "name": "Chase Checking",
  "type": "banking_checking",
  "on_budget": true,
  "balance": "1520.75",
  "cleared_balance": "1480.75",
  "pending_balance": "40.00",
  "closed": false,
  "notes": null,
  "linked": false,
  "last_reconciled_at": null,
  "created_at": "2026-01-12T15:04:05.000Z",
  "updated_at": "2026-07-01T09:30:00.000Z"
}
on_budget is true for banking and credit accounts (they participate in envelope budgeting) and false for investment and loan accounts.

​
List accounts

GET /v1/workspaces/{workspace_id}/accounts
Query parameterTypeDescription
include_closedbooleanInclude closed accounts. Default false.

​
Get an account

GET /v1/workspaces/{workspace_id}/accounts/{account_id}

​
Create an account

POST /v1/workspaces/{workspace_id}/accounts

curl -X POST https://api.kualia.com/v1/workspaces/WORKSPACE_ID/accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Emergency Fund",
    "type": "banking_savings",
    "initial_balance": "5000.00",
    "initial_balance_date": "2026-07-01"
  }'
FieldTypeRequiredDescription
namestringyesDisplay name
typestringyesAccount type (see below)
initial_balancestringnoStarting balance as a decimal string
initial_balance_datestringnoDate of the starting balance (YYYY-MM-DD, defaults to today)
Account types — banking_checking, banking_savings, banking_cash, banking_cash_management, banking_money_market, banking_cd, banking_other, credit_credit_card, credit_line_of_credit, credit_other, investment_brokerage, investment_401k, investment_ira, investment_roth_ira, investment_roth_401k, investment_hsa, investment_sep_ira, investment_simple_ira, investment_keogh, investment_529_plan, investment_403b, investment_other, loan_auto, loan_business, loan_commercial, loan_construction, loan_home_equity, loan_mortgage, loan_student, loan_other.

​
Update an account

PATCH /v1/workspaces/{workspace_id}/accounts/{account_id}
FieldTypeDescription
namestringRename the account
notesstringSet the account notes
closedbooleantrue closes the account (reconciles its cleared transactions), false reopens a closed one

​
Delete an account

DELETE /v1/workspaces/{workspace_id}/accounts/{account_id}
Only accounts with no active transactions can be deleted — otherwise the request fails with 400. Close the account instead if it has history you want to keep.