---
title: "Rendimento até Meta — quando cada meta é atingida"
method: POST
path: "/api/v1/calc/rendimento-ate-meta"
tags: ["calc", "financas"]
---

# Rendimento até Meta — quando cada meta é atingida

`POST /api/v1/calc/rendimento-ate-meta`

## Request

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

Para múltiplas metas (carro, viagem, casa) em paralelo, calcule em quantos meses o saldo (capital + aportes + juros) atinge cada alvo.

## Request body

- object
  - `metas` object[], required: Lista de metas-alvo (1 a 20). Para cada meta, calculamos quando o saldo atinge o alvo.
    - `nome` string, required: Nome da meta (ex: "Carro", "Viagem", "Reserva")
    - `valorAlvoCents` integer, required: Valor a ser atingido nesta meta em centavos. Ex: R$ 100.000 → 10000000.
  - `capitalInicialCents` integer: Capital já disponível em centavos. Ex: R$ 10.000 → 1000000. Padrão: 0
  - `aporteMensalCents` integer: Aporte mensal em centavos. Ex: R$ 500 → 50000. Padrão: R$ 500
  - `taxaMensalPercent` number: Taxa de rendimento mensal esperada em % (0 a 10). Ex: 0.7 = 0,7% ao mês (≈ Tesouro Selic líquido 2026). Padrão: 0,7%
  - `prazoMaximoMeses` integer: Prazo máximo da simulação em meses (1 a 1200). Se a meta não for atingida nesse prazo, mesesParaAtingir = null. Padrão: 600 (50 anos).
  - `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)