---
title: "Calculadora de Custo Total de Compra de Imóvel"
method: POST
path: "/api/v1/calc/custo-total-compra-imovel"
tags: ["calc", "imoveis"]
---

# Calculadora de Custo Total de Compra de Imóvel

`POST /api/v1/calc/custo-total-compra-imovel`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/custo-total-compra-imovel`
- Auth: HTTP bearer

Descubra o custo real de comprar um imóvel além do preço de venda: ITBI, cartório, corretagem, vistoria e custo do financiamento. Saiba exatamente quanto dinheiro você precisa ter disponível no dia da compra.

## Request body

- object
  - `valorImovelCents` integer, required: Valor de venda do imóvel em centavos. Ex: R$ 350.000 → 35000000
  - `itbiAliquotaPercent` number: Alíquota municipal do ITBI (Imposto sobre Transmissão de Bens Imóveis). Ex: 3 = 3%. Varia por cidade: São Paulo 3%, Rio 3%, Curitiba 2,7%. Padrão: 3%.
  - `corretorPercent` number: Percentual de honorários do corretor ou imobiliária sobre o valor do imóvel. Ex: 6 = 6%. Tabela COFECI/CRECI é 6%. Use 0 se a corretagem já está inclusa no preço ou se a compra é direta. Padrão: 6%.
  - `cartorioPercentOverride` number: Percentual personalizado para custos de cartório (escritura pública e registro de imóveis), quando você já tem uma cotação real. Ex: 1.2 = 1,2%. Se não informado, a calculadora usa estimativa de 0,8–1,5% conforme faixa de valor. Campo opcional.
  - `vistoriaCentsOverride` integer: Valor real da vistoria ou avaliação técnica do imóvel em centavos, quando você já tem orçamento. Ex: R$ 800 → 80000. Se não informado, a calculadora usa a estimativa padrão de R$ 800. Campo opcional.
  - `financiado` boolean: Se verdadeiro (true), inclui o custo total do financiamento (juros pagos ao longo do prazo) no cálculo. Se falso (false), considera compra à vista. Padrão: false.
  - `entradaPercent` number: Percentual do valor do imóvel pago como entrada no financiamento. Ex: 20 = 20%. Obrigatório quando "financiado" for verdadeiro. Campo opcional.
  - `taxaMensalPercent` number: Taxa de juros mensal do financiamento imobiliário. Ex: 0.8 = 0,8% ao mês (equivale a ~10% ao ano). Obrigatório quando "financiado" for verdadeiro. Campo opcional.
  - `prazoMeses` integer: Prazo total do financiamento em meses. Ex: 360 = 30 anos. Obrigatório quando "financiado" for verdadeiro. Campo opcional.
  - `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)