---
title: "Calculadora de Horas Extras"
method: POST
path: "/api/v1/calc/horas-extras"
tags: ["calc", "trabalhistas"]
---

# Calculadora de Horas Extras

`POST /api/v1/calc/horas-extras`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/horas-extras`
- Auth: HTTP bearer

Calcule o valor de horas extras com adicional de 50% ou 100% e reflexo em DSR (Descanso Semanal Remunerado). Permite divisor de horas customizável (220h, 200h, 180h).

## Request body

- object
  - `salarioBrutoCents` integer, required: Salário bruto mensal em centavos. Ex: R$ 4.400 → 440000
  - `horasExtras` number, required: Total de horas extras realizadas no mês. Ex: 20 horas extras. Máximo 500 horas (valor técnico — o limite legal CLT é 2h extras por dia).
  - `adicionalPercent` number: Percentual de adicional sobre a hora normal. Padrão 50 (50%, mínimo legal pela Constituição Federal art. 7º XVI). Use 100 para horas extras em domingos e feriados. Convenções coletivas podem prever percentual maior (60%, 75%, 80%).
  - `divisorHoras` integer: Divisor mensal de horas usado para calcular o valor da hora normal. Padrão 220 para jornada de 44 horas semanais. Use 200 para 40h semanais (segunda a sexta) ou 180 para 36h semanais (bancários, p.ex.).
  - `incluirDsr` boolean: Se verdadeiro (true), inclui o reflexo no DSR (Descanso Semanal Remunerado) conforme Súmula TST 172 — aplicável quando as horas extras são habituais. Se falso (false), calcula apenas o valor das horas extras sem reflexo no DSR. Padrão true.
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)