ynab_get_account
Read-onlyIdempotent
Retrieve detailed account information including current balance, cleared and uncleared balances, account type, and status. Provide account ID; optionally specify budget ID.
Instructions
Get details for a single account including current balance.
Args:
budget_id (string, optional): Budget UUID. Omit to use the default budget.
account_id (string, required): Account UUID.
response_format (string, optional): "json" or "markdown" (default: "markdown").
Returns: account (id, name, type, balance, cleared_balance, uncleared_balance, on_budget, closed), cached, cache_info
Errors:
"No default budget set" → run ynab_set_default_budget first
"Account not found" → invalid account_id
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget_id | No | ||
| account_id | Yes | ||
| response_format | No | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cached | No | Indicates if data was served from cache | |
| cache_info | No | Human-readable cache status message (e.g., "Cache hit", "Cache miss") | |
| usedDelta | No | Indicates if delta merge optimization was applied for budgets | |
| account | Yes | Account details |