---
title: "Consórcio vs Financiamento — qual sai mais barato?"
method: POST
path: "/api/v1/calc/consorcio-vs-financiamento"
tags: ["calc", "financas"]
---

# Consórcio vs Financiamento — qual sai mais barato?

`POST /api/v1/calc/consorcio-vs-financiamento`

## Request

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

Compare o custo total de adquirir um imóvel ou veículo por consórcio ou financiamento. Considera taxa de administração, juros e mês estimado de contemplação.

## Request body

- object
  - `valorBemCents` integer, required: Valor do bem (imóvel, carro ou outro) em centavos. Ex: R$ 500.000 → 50000000
  - `prazoMeses` integer, required: Prazo total do consórcio ou financiamento em meses (12 a 420). Ex: 240 = 20 anos
  - `taxaAdmTotalPercent` number: Taxa de administração total do consórcio sobre o valor do bem em % (5 a 50). Ex: 20 = 20% do valor do bem. Padrão: 20%
  - `taxaMensalFinanciamentoPercent` number: Taxa de juros mensal do financiamento em % ao mês (0,1 a 5). Ex: 0.8 = 0,8% ao mês. Padrão: 0,8%
  - `mesContemplacaoConsorcio` integer: Mês estimado em que ocorre a contemplação no consórcio (1 a 420). Ex: 60 = contemplação no 60º mês (5 anos). Padrão: 60
  - `correcaoAnualConsorcioPercent` number: Correção anual aplicada às parcelas do consórcio (Lei 11.795/2008). Imobiliários geralmente usam INCC (5-9% a.a. histórico); veículos usam IPCA (4-5% a.a.) ou INCC. Padrão 6% (INCC histórico médio). Passe 0 para simular consórcio sem correção (cenário não-realista).
  - `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)