---
title: "Simulador de Compra do Imóvel dos Sonhos"
method: POST
path: "/api/v1/calc/planejamento-compra-imovel"
tags: ["calc", "imoveis"]
---

# Simulador de Compra do Imóvel dos Sonhos

`POST /api/v1/calc/planejamento-compra-imovel`

## Request

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

Simule o custo completo de comprar seu imóvel: entrada, FGTS, ITBI, cartório, parcela do financiamento (SAC, Price ou Consórcio) e comparativo entre as 3 modalidades — tudo em uma tela.

## Request body

- object
  - `valorImovelCents` integer, required: Valor do imóvel em centavos. Ex: R$ 500.000 → 50000000
  - `percentualEntrada` number, required: Percentual de entrada (%). Ex: 20 = 20%
  - `fgtsCents` integer: Saldo do FGTS disponível para usar como entrada, em centavos. 0 se não vai usar.
  - `prazoMeses` integer, required: Prazo do financiamento em meses. Ex: 360 = 30 anos
  - `taxaJurosAnualBps` integer, required: Taxa de juros anual em basis points. Ex: 1050 = 10,5% ao ano
  - `modalidade` 'sac' | 'price' | 'consorcio', required: Modalidade: "sac" = amortização constante (parcela decrescente), "price" = parcelas fixas, "consorcio" = sem juros com taxa de administração
  - `percentualItbi` number: Alíquota do ITBI (%). Varia por município, geralmente 2-4%. Ex: 3 = 3%
  - `percentualCartorio` number: Estimativa de custos de cartório e registro (% do valor). Ex: 1.5 = 1,5%
  - `taxaAdminConsorcio` number: Taxa de administração total do consórcio ao longo do prazo (%). Ex: 18 = 18%
  - `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)