get_transactions
Retrieve YNAB transactions with filters for account, category, payee, month, or status (unapproved/uncategorized). Use the raw import payee name to disambiguate truncated payee names.
Instructions
Get transactions with optional filters. Use type='unapproved' or type='uncategorized' to filter. Optionally filter by account, category, payee, or month. Each returned transaction includes 'import_payee_name_original' — the raw merchant string from the bank import (e.g. 'AplPay LS ONION RIVEMONTPELIER VT') — which encodes processor flag, merchant name (often longer than the cleaned payee_name), and city+state. This is the primary disambiguation field when payee_name is truncated or ambiguous. Note: large date ranges (6+ months on a busy budget) can return 50KB+ of data; narrow with categoryId/payeeId/month filters when possible.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budgetId | No | Budget ID (uses default if not provided) | |
| sinceDate | No | Only return transactions on or after this date (YYYY-MM-DD) | |
| type | No | Filter by approval/categorization status | |
| accountId | No | Filter by account ID | |
| categoryId | No | Filter by category ID | |
| payeeId | No | Filter by payee ID | |
| month | No | Filter by month (YYYY-MM-DD, first of month) | |
| lastKnowledgeOfServer | No | Delta request server knowledge. When provided, returns { transactions, server_knowledge }. |