---
title: "Plano de Saúde Familiar — quanto vai custar por mês?"
method: POST
path: "/api/v1/calc/plano-saude-orcamento-familiar"
tags: ["calc", "saude"]
---

# Plano de Saúde Familiar — quanto vai custar por mês?

`POST /api/v1/calc/plano-saude-orcamento-familiar`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/plano-saude-orcamento-familiar`
- Auth: HTTP bearer

Estimativa da mensalidade do plano de saúde por composição familiar (titular, cônjuge, filhos), baseada na tabela de faixas etárias da ANS (RN 195/2009) e nível de cobertura escolhido. Inclui range entre operadoras.

## Request body

- object
  - `titularIdade` integer: Idade do titular do plano em anos inteiros, de 18 a 110. A mensalidade aumenta progressivamente pelas 10 faixas etárias da ANS (RN 195/2009). Padrão: 35
  - `conjugeIdade` integer: Idade do cônjuge ou companheiro(a) em anos inteiros, de 18 a 110. Informe 0 se não houver cônjuge no plano. Padrão: 0 (sem cônjuge)
  - `filhosIdades` integer[]: Lista com as idades dos filhos dependentes em anos inteiros (de 0 a 30 anos cada), com no máximo 5 filhos. Ex: [5, 8, 12]. Deixe vazio ([]) se não houver filhos. Padrão: [] (sem filhos)
  - `faixaCobertura` 'basico' | 'intermediario' | 'premium': Nível de cobertura desejado: "basico" (enfermaria + rede regional, multiplicador 1,0×), "intermediario" (apartamento individual + odontológico + rede ampliada, multiplicador 1,6×) ou "premium" (apartamento + odonto + reembolso amplo + rede nacional, multiplicador 2,5×). Padrão: "intermediario"
  - `addOnsMensais` object[]: Add-ons MENSAIS de saúde ALÉM da mensalidade do plano principal, agrupados por categoria. Cada item: { categoria, valorCents, descricao? }. Categorias: medicacao_continua (uso contínuo), plano_odontologico (separado), plano_social (auxílio social), telemedicina, fisioterapia_recorrente, terapia_psicologia, suplementacao, outro. Somam ao orçamento mensal/anual. Padrão []. Use "outro" + descrição para casos não cobertos.
    - `categoria` 'medicacao_continua' | 'plano_odontologico' | 'plano_social' | 'telemedicina' | 'fisioterapia_recorrente' | 'terapia_psicologia' | 'suplementacao' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `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)