ynab_list_accounts
List all accounts from your YNAB budget with pagination. Supports optional budget ID, limit, offset, and returns account details in JSON or markdown format.
Instructions
List all accounts for a budget.
Args:
budget_id (string, optional): Budget UUID. Omit to use the default budget.
limit (int, optional): Max results per page. Default: 50.
offset (int, optional): Zero-based offset for pagination. Default: 0.
response_format (string, optional): "json" or "markdown" (default: "markdown").
Returns: accounts[], total_count, returned_count, offset, has_more, next_offset, cached, cache_info
Examples:
List all accounts (default budget): call with no args
Page 2: set limit=20, offset=20
Errors:
"No default budget set" → run ynab_set_default_budget first
"UNAUTHORIZED" → YNAB token expired
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| budget_id | No | ||
| response_format | No | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cached | No | Indicates if data was served from cache | |
| offset | Yes | Offset used for this response | |
| accounts | Yes | List of accounts | |
| has_more | Yes | Whether more items exist beyond this page | |
| usedDelta | No | Indicates if delta merge optimization was applied for budgets | |
| cache_info | No | Human-readable cache status message (e.g., "Cache hit", "Cache miss") | |
| next_offset | No | Offset for next page, if has_more is true | |
| total_count | Yes | Total number of items available | |
| returned_count | Yes | Number of items returned |