List the YNAB budgets accessible with this token, with their currency.

Returns for each budget: id, name, currency iso_code, last modified date. Useful to grab a specific budget_id (otherwise use "last-used" elsewhere).

List a budget's accounts with their balance (converted to currency units).

Returns: id, name, type, on_budget (bool), current balance, closed flag.

List category groups and their categories, with budgeted / activity / balance.

Each category: id, name, budgeted, activity, balance (all in currency units). Needed to grab a category_id before creating/categorizing a transaction.

List a budget's payees, paginated.

Returns id + name. Useful to find the id of a recurring merchant.

List a budget's transactions, with filters and pagination.

Filter by account OR by category (not both, per the API), by date (since_date) and by type (uncategorized / unapproved). Amount is in currency units (negative = expense). Returns id, date, payee_name, amount, category_name, memo, approved, cleared.

Create a transaction in an account.

The amount is given in normal currency units (e.g. -12.50 for a 12.50 expense); conversion to milliunits is automatic. Returns the new id.

Partially update a transaction (categorize, approve, fix a memo…).

Only the provided fields change. Typical case: assign category_id + approved=true to an imported, uncategorized transaction.

Budget summary for a month: to be budgeted, income, budgeted, activity, age of money.