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

# Timesheet Calculator

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

## Request

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

Turn clock-in and clock-out times into hours worked: the net hours per day after the break, the weekly total in decimal hours and in hours and minutes, the split between regular and overtime hours at a threshold you choose, and gross pay at a flat hourly rate. Overnight shifts are handled, a day nobody worked is reported rather than guessed, and the result carries the page's caveat that this is an indication, not payroll or legal advice.

## Request body

- object
  - `days` object[]
    - `label` string
    - `start` string
    - `end` string
    - `breakMinutes` integer
  - `overtimeThresholdHours` integer
  - `hourlyRate` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `days` object[]
      - `label` string
      - `start` string
      - `end` string
      - `breakMinutes` integer
      - `hours` integer
      - `overnight` boolean
    - `totalHours` number
    - `totalHoursHm` string
    - `regularHours` number
    - `overtimeHours` integer
    - `overtimeThresholdHours` integer
    - `daysWorked` integer
    - `hourlyRate` integer
    - `grossPay` number
    - `note` string

## 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)