get_group_stats
Spending summary for a group from the user's POV: monthly totals, lifetime totals, and per-member breakdown. Use for questions like "how much did we spend this month" or "who has paid the most".
list_settlements
List settlements (payments) in a group - history plus any pending ones awaiting confirmation. status is pending/confirmed/rejected. Use for "who still needs to confirm" or "what payments happened".
ping
Health check. Returns "pong" and server time. No data access.
preview_bill
Compute the exact equal split for a proposed bill and return a per-person breakdown plus a preview_token. ALWAYS call this first and show the breakdown to the user. Then pass the SAME values plus the preview_token to create_bill. No data is written.
create_bill
Create an equal-split bill paid by the user. Requires a preview_token from preview_bill and the SAME values. Splits the total equally among participants (or all group members). Subject to the same daily bill limit as the app.
preview_payment
Compute a settlement (who pays whom, how much) and return a preview_token. ALWAYS call this first and show it to the user. No data is written.
record_payment
Record a settlement between the user and another member. Requires a preview_token from preview_payment with the SAME values. This creates a PENDING request — the other person must confirm it in the PrismSplit app before any balance changes. It does not move money on its own.
add_item
Append a line item to an existing bill. Pass a bill_id from list_bills/get_bill. Note: this changes the bill — confirm with the user first.
create_group
Create a new bill-splitting group owned by the user. Returns the group id and an invite_code others can use to join. Use this to start a fresh trip/household/event.
add_member
Add a person to a group as a guest (someone without a PrismSplit account, so you can split bills with them). Registered users join via the invite_code instead. Returns the new member_id (usable in create_bill participants).
update_bill
Update a bill's metadata (title, category, merchant, location). Does NOT change amounts or splits - use the app for those. Pass only the fields to change.
delete_bill
Permanently remove a bill (soft delete). This is destructive and affects balances. You MUST set confirm=true, and you should confirm with the user first.
list_comments
List the comments/discussion on a bill.
add_comment
Post a comment on a bill (visible to the group, like the app's bill discussion).