---
title: "Calculate tip and split a restaurant bill among multiple people. Given a bill amount, tip percentage, and number of diners, returns the tip amount, total with tip, per-person share, and effective tip percentage. Supports rounding up to the nearest whole number for convenience. Defaults to 18% tip for 1 person. Currency-agnostic — works with any monetary unit."
method: POST
path: "/api/tip_calculator"
tags: ["general"]
---

# Calculate tip and split a restaurant bill among multiple people. Given a bill amount, tip percentage, and number of diners, returns the tip amount, total with tip, per-person share, and effective tip percentage. Supports rounding up to the nearest whole number for convenience. Defaults to 18% tip for 1 person. Currency-agnostic — works with any monetary unit.

`POST /api/tip_calculator`

## Request

- Base URL: `https://calc.engineer`
- URL: `https://calc.engineer/api/tip_calculator`
- Auth: none declared

## Request body

- object
  - `bill_amount` number, required: Total bill amount before tip (any currency).
  - `tip_pct` number: Tip percentage. Common values: 15 (standard), 18 (good), 20 (great), 25 (excellent). Defaults to 18%.
  - `split` number: Number of people splitting the bill. Defaults to 1 (no split).
  - `round_up` boolean: Round the total up to the nearest whole number. Defaults to false.

## Response `200`

Computed result for tip_calculator

- object
  - `result` object, required
    - `tip_amount` number, required: Tip amount.
    - `total` number, required: Bill plus tip.
    - `per_person_tip` number, required: Each person's share of the tip.
    - `per_person_total` number, required: Each person's total including their share of the bill and tip.
    - `effective_tip_pct` number, required: Actual tip percentage after rounding (if round_up is true, may differ from input).
  - `tool` string, required
  - `version` string, required
  - `computed_at` string, date-time, required
  - `chain` object, required
    - `feeds` unknown[]
      - unknown
    - `accepts_from` unknown[]
      - unknown

## Other responses

- `400`: Validation error or invalid JSON
- `404`: Tool not found

---

[API](https://skmtc.dev/calc/apis/calc-engineer-api.md) · [All operations](https://skmtc.dev/calc/apis/calc-engineer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calc/apis/calc-engineer-api/revisions/8830480ec488?raw)