---
title: "Use this when you want penny-accurate tip and bill-split figures."
method: POST
path: "/v1/tip"
tags: ["finance"]
---

# Use this when you want penny-accurate tip and bill-split figures.

`POST /v1/tip`

## Request

- Base URL: `https://api.clean.tools`
- URL: `https://api.clean.tools/v1/tip`
- Auth: none declared

Use this when you want penny-accurate tip and bill-split figures. Given a bill amount, a tip percentage, and an optional number of people (default 1; values below 1 are treated as 1), returns the tip amount, grand total, and the per-person tip and per-person total, all rounded to cents. Deterministic: same input, same output. Example: bill=120, tipPercent=18, people=4 -> tipAmount=21.6, total=141.6, perPersonTotal=35.4.

## Request body

- object
  - `bill` number, required: The pre-tip bill amount in dollars. Required. Must be zero or positive.
  - `tipPercent` number, required: The tip as a percentage of the bill (e.g. 20 for 20%). Required. Must be zero or positive.
  - `people` integer: Number of people splitting the bill. Optional, defaults to 1; values below 1 are treated as 1.

## Response `200`

Structured tool result.

- object
  - `tool` string
  - `result` object
    - `bill` number, required: The pre-tip bill amount, rounded to cents.
    - `tipPercent` number, required: The tip percentage that was applied (echoed as supplied).
    - `people` integer, required: Number of people the bill was split across (>= 1).
    - `tipAmount` number, required: Total tip in dollars, rounded to cents.
    - `total` number, required: Bill plus tip in dollars, rounded to cents.
    - `perPersonTip` number, required: tipAmount divided by people, rounded to cents.
    - `perPersonTotal` number, required: total divided by people, rounded to cents.

## Other responses

- `400`: Invalid input or the tool reported an error.
- `413`: Request body exceeds the 128 KB limit.
- `429`: Rate limit exceeded; the response carries Retry-After and RateLimit-* headers — honor them and add jitter.

---

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