splitwise_get_group_balances
Show each member's balance in one Splitwise group and who should pay whom to settle up, with per-currency amounts and the debt source.
Instructions
Show each member's balance in one group and who should pay whom to settle it.
Calls GET /get_group/{group_id} and renders the members' non-zero balances per
currency, then the group's debts as From → To amount CUR (From owes To), with names
resolved from the group's own members (an id not among them is shown as user N).
Uses simplified_debts; when Splitwise returns none, falls back to original_debts
and says so. Sign convention: positive = the member is owed by the group; negative =
the member owes the group. Settled-up members are listed by name only. An amount
that is not a plain decimal is shown raw and flagged (unparsed).
When to Use:
"Who owes whom in the Trip group?", "how do we settle up the apartment?".
Before recording a settle-up payment, to get the exact amounts and user ids.
When NOT to Use:
For your balances across all friends (use
splitwise_get_balances).For non-group expenses: group_id 0 is the non-group pseudo-group;
/get_group/0answers but lists only you as a member, so per-friend balances come fromsplitwise_get_balances, not from here.For the group's details, invite link or membership changes (use
splitwise_get_group,splitwise_add_user_to_group,splitwise_remove_user_from_group).To find a group id from its name (use
splitwise_resolve_group/splitwise_get_groups).
Returns:
Markdown: a member table (First Last (id N) | +20.00 USD), the settled-up members,
and the debts list with its source (simplified_debts or original_debts), capped at
50 rows each. JSON: {group: {id, name}, sign_convention, members: [raw members], debts_source: "simplified_debts" | "original_debts" | null, debts: [raw debts]}.
Examples:
params = {"group_id": 12345}
params = {"group_id": 12345, "response_format": "json"}
Error Handling:
403 means you are not a member of that group; 404 means the id is wrong or the group
was deleted (splitwise_undelete_group restores it) — or, for group_id 0, that the
pseudo-group is not served here (use splitwise_get_balances). Errors come back as an
Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |