---
title: "Calculadora de ITBI 2026"
method: POST
path: "/api/v1/calc/itbi"
tags: ["calc", "imoveis"]
---

# Calculadora de ITBI 2026

`POST /api/v1/calc/itbi`

## Request

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

Calcule o ITBI (Imposto de Transmissão de Bens Imóveis) na compra do seu imóvel. Suporta desconto SFH primeiro imóvel.

## Request body

- object
  - `valorTransacaoCents` integer, required: Valor da transação (preço de compra e venda) do imóvel em centavos. Ex: R$ 300.000 → 30000000
  - `valorVenalCents` integer: Valor venal de referência atribuído pela prefeitura em centavos (opcional). Quando informado, a base de cálculo será o maior entre este valor e o valor da transação — conforme regra geral municipal. Consulte o IPTU ou o site da prefeitura.
  - `aliquotaPercent` number: Alíquota municipal do ITBI definida em lei pela sua cidade. Ex: 3 = 3%. São Paulo 3%, Rio de Janeiro 3%, Curitiba 2,7%, Brasília 3%. Consulte o site da prefeitura para o valor exato. Padrão: 3%.
  - `sfhPrimeiroImovel` boolean: Se verdadeiro (true), aplica o benefício SFH para aquisição do primeiro imóvel residencial financiado (Lei 4.380/1964): alíquota reduzida em 50% sobre a parcela do valor até o teto SFH. Se falso (false), aplica alíquota cheia sobre todo o valor. Padrão: false.
  - `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)