---
title: "Seguro de Vida — quanto contratar?"
method: POST
path: "/api/v1/calc/seguro-vida-quanto-contratar"
tags: ["calc", "seguros"]
---

# Seguro de Vida — quanto contratar?

`POST /api/v1/calc/seguro-vida-quanto-contratar`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/seguro-vida-quanto-contratar`
- Auth: HTTP bearer

Capital ideal para proteger sua família + faixa estimada de prêmio mensal por idade. Heurística baseada em renda × meses de proteção, somando dívidas e descontando reserva.

## Request body

- object
  - `rendaMensalCents` integer: Renda mensal líquida do segurado em centavos. É a base para calcular o capital necessário: o seguro deve ser capaz de substituir essa renda pelo período de proteção. Ex: R$ 10.000/mês → 1000000. Padrão: R$ 10.000.
  - `dependentes` integer: Número de dependentes financeiros do segurado (filhos, cônjuge sem renda própria, pais idosos etc.). Esse valor determina os meses de proteção aplicados: 0 dependentes = 12 meses; 1 a 2 dependentes = 60 meses; 3 ou mais dependentes = 120 meses. Padrão: 2.
  - `dividasCents` integer: Total de dívidas em centavos que devem ser quitadas com o capital do seguro (financiamento imobiliário, empréstimos, cartão de crédito etc.). Esse valor é somado ao capital calculado pela renda. Ex: R$ 200.000 em financiamento → 20000000. Padrão: 0 (sem dívidas).
  - `reservaAtualCents` integer: Patrimônio líquido já acumulado em centavos que poderia substituir a renda para os dependentes (investimentos de longo prazo, imóvel quitado etc.). Esse valor é subtraído do capital ideal — quanto maior a reserva, menor o seguro necessário. Não inclua a reserva de emergência, pois ela tem outra finalidade. Ex: R$ 150.000 investidos → 15000000. Padrão: 0.
  - `idade` integer: Idade atual do segurado em anos inteiros. Determina a faixa etária atuarial usada para estimar o prêmio mensal: quanto mais jovem, menor o prêmio. Faixas: 18–29, 30–39, 40–49, 50–59, 60–65. Padrão: 35.
  - `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)
