---
title: "Calculadora do Custo Total de Ter um Filho — 0 a 22 anos"
method: POST
path: "/api/v1/calc/custo-total-ter-filho"
tags: ["calc", "nichos"]
---

# Calculadora do Custo Total de Ter um Filho — 0 a 22 anos

`POST /api/v1/calc/custo-total-ter-filho`

## Request

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

Quanto custa ter um filho do nascimento até a faculdade no Brasil. Tabelas POF/IBGE atualizadas por IPCA Educação. Mostra custo nominal, valor presente e aporte mensal necessário pra cobrir tudo.

## Request body

- object
  - `cidadeOuRegiao` 'metropole_capital' | 'cidade_media' | 'interior': Localidade onde a família reside. "metropole_capital" = capitais e regiões metropolitanas (São Paulo, Rio, BH etc.); "cidade_media" = cidades de 100k-1M habitantes; "interior" = municípios menores. Impacta custo de creche, escola e saúde.
  - `padraoEducacao` 'publica' | 'particular_basica' | 'particular_premium' | 'bilingue': Padrão de educação pretendido. "publica" = escola pública sem mensalidade; "particular_basica" = escola particular comum (R$ 1.500-3.000/mês); "particular_premium" = escola premium (R$ 3.000-8.000/mês); "bilingue" = escola bilíngue (R$ 4.000-12.000/mês). Padrão: particular_basica.
  - `padraoSaude` 'sus' | 'plano_basico' | 'plano_intermediario' | 'plano_premium': Cobertura de saúde da criança. "sus" = sistema público gratuito; "plano_basico" = plano de saúde simples (~R$ 300/mês); "plano_intermediario" = plano intermediário (~R$ 600/mês); "plano_premium" = plano completo (~R$ 1.200+/mês). Padrão: plano_intermediario.
  - `temUniversidade` boolean: Se verdadeiro (true), o custo da universidade (dos 18 aos 22 anos) é incluído no total. Se falso (false), o cálculo vai apenas até os 18 anos.
  - `tipoUniversidade` 'publica_zero' | 'particular_basica' | 'particular_premium' | 'exterior': Tipo de universidade considerado para os anos 18-22. "publica_zero" = federal/estadual sem mensalidade (só custos de vida); "particular_basica" = faculdade particular comum (R$ 800-2.500/mês); "particular_premium" = faculdade premium (R$ 3.000-8.000/mês); "exterior" = universidade no exterior (R$ 8.000-30.000/mês). Padrão: particular_basica.
  - `numeroFilhosNoOrcamento` integer: Quantidade de filhos cujo custo será somado. A calculadora aplica 15% de economia de escala por filho adicional sobre itens compartilháveis. Padrão: 1.
  - `inflacaoEducacaoAnualPercent` number: Inflação anual esperada para custos de educação (mensalidade, material, atividades). Em %. Ex: 8 = 8% ao ano. Histórico IPCA Educação: ~8% a.a. Padrão: 8.
  - `taxaDescontoAnualPercent` number: Taxa de desconto anual usada para trazer o custo futuro a valor presente (custo de oportunidade do dinheiro). Em %. Ex: 6 = 6% ao ano. Padrão: 6.
  - `gastosExtraPorFase` object[]: Gastos extracurriculares MENSAIS recorrentes ALÉM do padrão de educação+saúde, agrupados por categoria. Cada item: { categoria, valorCents, descricao? }. Categorias: idiomas (inglês/espanhol), esportes (natação/futebol/judô), musica_artes (piano/balé), reforco_escolar, terapia_psicologia, creche_extra (após-aula), cursos_online, material_didatico_extra, outro. Esses valores são somados ao custo mensal de cada fase 0-17 (não aplicado na universidade). Padrão []. Use "outro" + descrição para casos não cobertos.
    - `categoria` 'idiomas' | 'esportes' | 'musica_artes' | 'reforco_escolar' | 'terapia_psicologia' | 'creche_extra' | 'cursos_online' | 'material_didatico_extra' | '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.
  - `eventosOpcionais` object[]: Gastos únicos ou rendas extras esperadas: viagem em família, mensalidade da primeira escola, auxílio creche da empresa, bolsa estudos, etc. Tipos `gasto_unico`/`retirada` aumentam o custo total; `aporte_extra`/`rendimento_extra` reduzem (ex: auxílio creche, pensão, bolsa). Frequências recorrentes (mensal/anual) aplicam-se ao longo do horizonte de 22 anos; `unica`/`irregular` incidem só uma vez. Padrão []. Form começa vazio — user adiciona conforme precisa.
    - `tipo` 'aporte_extra' | 'retirada' | 'rendimento_extra' | 'gasto_unico' | 'outro', required
    - `modoValor` 'absoluto' | 'percent_salario' | 'percent_renda'
    - `valorCents` integer
    - `percent` number
    - `frequencia` 'mensal' | 'bimestral' | 'trimestral' | 'semestral' | 'anual' | 'unica' | 'irregular'
    - `descricao` string: Rótulo livre do user (ex: "PPR meta 2026", "Bônus retenção").
    - `monthsApplicable` integer[]
    - `ativo` boolean
  - `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)