List expenses
list_expensesRead-only
List the business's expenses with amount, date, category account, linked bank transaction and notes. These are recorded expense entries; for recorded income use list_income, and for raw bank-feed lines use list_transactions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only rows on/before this date (ISO 8601). Rows without a date are kept. | |
| max | No | Only rows whose amount is at most this (inclusive). Rows with no amount are excluded when min/max is set. | |
| min | No | Only rows whose amount is at least this (inclusive). Rows with no amount are excluded when min/max is set. Applied before pagination. | |
| from | No | Only rows on/after this date (ISO 8601, e.g. "2026-01-01"). Rows without a date are kept. | |
| limit | No | Max rows to return in this page (default 50). Responses include next_cursor / truncated / total; pass next_cursor back as `cursor` to fetch the next page. Never silently truncated. | |
| query | No | Case-insensitive substring filter — keeps only rows whose text (name, notes, and other string fields) contains this. Applied before pagination, so total/next_cursor reflect the filtered set. | |
| cursor | No | Opaque pagination cursor. Omit for the first page; pass the next_cursor from a previous response verbatim to fetch the next page. |