Get transactions in a date range
get_transactions_in_rangeReads- What it does
- Reads only. Changes nothing.
- Permission
- Transactions, read
transactions:read
What your assistant is told
List the calling user's transactions in a time window, newest first. start_iso is inclusive, end_iso is exclusive, and both are ISO-8601 timestamps that MUST carry the user's UTC offset — without one the window is refused, because a month asked in UTC is not the user's month; ask for their offset if you don't know it, and bound a month with their local midnights. Optionally filter to one category (name or id) and/or to expenses-only (is_expense true) or income-only (false). Optionally restrict to one account (id, alias or IBAN). limit caps the result count (default 100, max 500). Returns a flat list of transactions with their resolved category names and minor-unit amounts. This is a read — it changes nothing. Do NOT assume the list is exhaustive when it hits limit; narrow the range or raise the limit if you need more.
Parameters
startIsotext, requiredStart of the window, inclusive. ISO-8601 WITH the user's UTC offset, e.g. "2026-06-01T00:00:00+03:00". Refused without one.endIsotext, requiredEnd of the window, exclusive. ISO-8601 WITH the user's UTC offset, e.g. "2026-07-01T00:00:00+03:00". Refused without one.categorytext, optionalOptional category NAME or UUID to filter to. Omit for all categories.isExpensetrue or false, optionalOptional: true = expenses only, false = income only, omit = both.limitwhole number, optionalMax rows to return (default 100, capped at 500).accounttext, optionalOptional account id, alias or IBAN to filter to. Omit for every account.