---
title: "Tip Calculator"
method: POST
path: "/api/v1/tools/tip-calculator"
tags: ["tools"]
---

# Tip Calculator

`POST /api/v1/tools/tip-calculator`

## Request

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

Tip on a restaurant bill at a percentage, the total, and the even split per person. Can round the total up to the next whole unit, in which case the tip absorbs the difference.

## Request body

- object
  - `bill` number
  - `tipPercent` integer
  - `people` integer
  - `roundUp` boolean

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `bill` number
    - `tipPercent` integer
    - `people` integer
    - `roundUp` boolean
    - `tip` number
    - `total` number
    - `perPerson` object
      - `total` number
      - `tip` number
    - `effectiveTipPercent` 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)