---
title: "Calculadora IRPF — Restituição 2026"
method: POST
path: "/api/v1/calc/irpf-restituicao"
tags: ["calc", "impostos"]
---

# Calculadora IRPF — Restituição 2026

`POST /api/v1/calc/irpf-restituicao`

## Request

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

Simule sua declaração anual do IRPF. Compara modelo completo (com deduções) vs. simplificado (desconto padrão) e mostra a melhor opção.

## Request body

- object
  - `rendaTributavelAnualCents` integer, required: Valor em centavos. Total de rendimentos tributáveis recebidos durante o ano-calendário: salários, pró-labore, aluguéis, honorários etc. Não inclui rendimentos isentos (FGTS, indenizações, dividendos). Ex: renda anual de R$ 80.000 → 8000000.
  - `inssPagoAnualCents` integer: Valor em centavos. Total de contribuições ao INSS descontadas ou pagas durante o ano, dedutível integralmente da base de cálculo do IRPF no modelo completo. Inclui contribuições como empregado, contribuinte individual ou facultativo. Padrão: 0.
  - `irpfRetidoAnualCents` integer: Valor em centavos. Total de IRPF retido na fonte (IRRF) durante o ano pelo empregador ou pagador de rendimentos. Informado no informe de rendimentos. É o valor a ser comparado com o imposto devido para determinar restituição ou complemento. Padrão: 0.
  - `dependentes` integer: Número de dependentes legais na declaração (filhos, cônjuge, pais etc.). No modelo completo, cada dependente deduz R$ 2.275,08 ao ano da base de cálculo. Mínimo 0, máximo 20. Padrão: 0.
  - `despesasMedicasCents` integer: Valor em centavos. Total de despesas médicas pagas no ano (consultas, exames, internações, plano de saúde, odontologia, fisioterapia etc.), dedutíveis sem teto no modelo completo. Exige comprovantes com CNPJ ou CPF do profissional e seu CPF. Padrão: 0.
  - `despesasEducacaoCents` integer: Valor em centavos. Total de despesas de educação pagas no ano para você e seus dependentes (mensalidades de escola, graduação, pós-graduação). Sujeito ao teto anual por pessoa (R$ 3.561,50 em 2026). Cursos livres, material e transporte escolar não são dedutíveis. Padrão: 0.
  - `outrasDeducoes` object[]: Outras deduções dedutíveis no IRPF (PGBL, pensão alimentícia judicial, contribuições incentivadas, livro caixa autônomo), agrupadas por categoria. Cada item: { categoria, valorCents, descricao? }. Use "outro" + descrição livre para casos não cobertos.
    - `categoria` 'pensao_judicial' | 'previdencia_privada_pgbl' | 'doacoes_incentivadas' | 'contribuicao_oficial_inss' | 'livro_caixa' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `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)