search_transactions
Find YNAB transactions by payee, category, account, or date range, combining optional filters to narrow results and flag matching split-transaction portions.
Instructions
Searches transactions in a budget by payee, category, account, and/or date range. All filters are optional and combine together. The category filter also matches the portions of split transactions: a split that matches is returned as its parent transaction with the matching portions flagged "matched": true. Split transactions include a 'splits' array showing each portion's category and amount.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return, most recent first. | |
| budget_id | No | The budget ID, or 'last-used' for the most recently used budget. | last-used |
| payee_name | No | Partial, case-insensitive match on payee name. | |
| since_date | No | Only include transactions on or after this date (YYYY-MM-DD). | |
| until_date | No | Only include transactions on or before this date (YYYY-MM-DD). | |
| account_name | No | Partial, case-insensitive match on account name. | |
| category_name | No | Partial, case-insensitive match on category name. |