---
title: "Split Bill Calculator"
method: POST
path: "/api/v1/tools/split-bill-calculator"
tags: ["tools"]
---

# Split Bill Calculator

`POST /api/v1/tools/split-bill-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/split-bill-calculator`
- Auth: HTTP bearer

Settle up a group who have been paying for each other. Each expense is paid by one person and shared evenly by everyone or by the people named on it, with an optional tip added first. Returns what each person paid, owes and is owed, plus the shortest set of transfers that clears the group, optionally rounded to whole notes.

## Request body

- object
  - `people` string[]
  - `expenses` object[]
    - `payer` string
    - `description` string
    - `amount` integer
  - `tipPercent` integer
  - `roundTransfersTo` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `people` string[]
    - `total` integer
    - `tipPercent` integer
    - `balances` object[]
      - `person` string
      - `paid` integer
      - `owed` integer
      - `balance` integer
    - `transfers` object[]
      - `from` string
      - `to` string
      - `amount` integer

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)