splitwise_get_expenses
List Splitwise expenses newest first, filtered by group, friend, or date range, to review spending and find expense IDs for updates.
Instructions
List expenses, newest first, optionally filtered by group, friend and date range.
Calls GET /get_expenses. Splitwise includes DELETED expenses in this list; they are
hidden by default and the response says how many were hidden (include_deleted=true
shows them, tagged [deleted]). Settle-up payments are tagged [settle-up]. Each row
shows the date, description, full cost, group, who paid (shares with paid_share > 0)
and — when current_user_id is given — your net on that expense.
Sign convention: "Your net" is your net_balance on the expense; positive = owed to
you (you paid more than your share), negative = you owe.
When to Use:
"What did we spend in the Lima trip group?" (group_id) or "expenses with Ana" (friend_id).
Finding an expense id before reading, updating or deleting it.
Reviewing recent activity in a date window (dated_after / dated_before).
When NOT to Use:
To see one expense's full split, repayments and comments (use
splitwise_get_expense).To get balances per friend or per group (use
splitwise_get_balances/splitwise_get_group_balances).To turn a group or friend NAME into an id (use
splitwise_resolve_group/splitwise_resolve_friend).
Returns:
Markdown: a table | id | Date | Description | Cost | Group | Paid by | (Your net) |
plus the hidden-deleted count and the next offset. JSON: {count, returned_by_api, hidden_deleted, limit, offset, has_more, next_offset, expenses: [raw expense objects]}.
Pagination:
limit (1-100, default 20) is sent to Splitwise; has_more is true when Splitwise
returned a full page, and the next offset is offset + rows returned by Splitwise
(deleted rows count toward it even when hidden). Markdown shows at most 50 rows; the
note under the table gives the offset to continue from.
Examples:
params = {"group_id": 12345, "dated_after": "2026-09-01"}
params = {"friend_id": 678, "limit": 50, "current_user_id": 491923}
params = {"limit": 20, "offset": 20, "response_format": "json"}
Error Handling: Passing both group_id and friend_id is refused (Splitwise would ignore friend_id). 401 → API key missing/regenerated; 403 → you are not a member of that group; 429 → back off for Retry-After seconds.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |