---
title: "Meta de Poupança Mensal — quanto guardar por mês (multi-metas)"
method: POST
path: "/api/v1/calc/meta-poupanca-mensal"
tags: ["calc", "financas"]
---

# Meta de Poupança Mensal — quanto guardar por mês (multi-metas)

`POST /api/v1/calc/meta-poupanca-mensal`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/meta-poupanca-mensal`
- Auth: HTTP bearer

Calcule o aporte mensal necessário para atingir múltiplas metas financeiras (carro, viagem, casa) em paralelo. Veja a viabilidade total comparando com sua renda e o breakdown por meta.

## Request body

- object
  - `metas` object[], required: Lista de metas financeiras (1 a 20). Cada item: { nome, valorAlvoCents, prazoMeses, valorJaPoupadoCents? }. O cálculo agrega o aporte mensal total e expõe breakdown por meta.
    - `nome` string, required: Nome da meta (ex: "Carro novo", "Viagem Europa", "Entrada apartamento"). 1 a 40 caracteres.
    - `valorAlvoCents` integer, required: Valor a ser acumulado nesta meta em centavos. Ex: R$ 50.000 → 5000000.
    - `prazoMeses` integer, required: Prazo para atingir esta meta em meses (1 a 600).
    - `valorJaPoupadoCents` integer: Valor já guardado especificamente para esta meta em centavos. Padrão: 0.
  - `taxaMensalPercent` number: Taxa de rendimento mensal esperada em % (0 a 10). Aplica para todas as metas. Ex: 0.7 = 0,7% ao mês (≈ Tesouro Selic líquido 2026). Padrão: 0,7%
  - `rendaMensalCents` integer: Renda líquida mensal em centavos. Usada para calcular o percentual da renda comprometido com o aporte total. Ex: R$ 5.000 → 500000. Padrão: R$ 5.000
  - `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)