---
title: "Planejador de Viagem dos Sonhos"
method: POST
path: "/api/v1/calc/planejamento-viagem-sonho"
tags: ["calc", "financas"]
---

# Planejador de Viagem dos Sonhos

`POST /api/v1/calc/planejamento-viagem-sonho`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/planejamento-viagem-sonho`
- Auth: HTTP bearer

Estime o custo total da sua viagem — passagem, hospedagem, gastos diários e seguro viagem — e descubra quanto guardar por mês para realizá-la em 12, 24 ou 36 meses.

## Request body

- object
  - `tipoViagem` 'nacional' | 'internacional', required: "nacional" = destino dentro do Brasil, "internacional" = destino no exterior (aplica câmbio se moedaDestino ≠ BRL)
  - `numeroPessoas` integer, required: Número total de viajantes
  - `duracaoDias` integer, required: Duração da viagem em dias
  - `custoPassagemTotalCents` integer, required: Custo total das passagens de todos os viajantes, em centavos BRL. Use 0 se vai usar milhas.
  - `hospedagemDiariaCents` integer, required: Custo diário de hospedagem (total, não por pessoa), em centavos BRL.
  - `gastoDiarioPorPessoaCents` integer, required: Estimativa de gastos diários por pessoa (alimentação, transporte local, atrações), em centavos BRL.
  - `incluirSeguroViagem` boolean, required: Se verdadeiro (true), inclui estimativa de seguro viagem no custo total. Se falso (false), não inclui.
  - `moedaDestino` 'BRL' | 'USD' | 'EUR' | 'GBP' | 'ARS' | 'CLP' | 'PEN': Moeda principal do destino. Use "BRL" para viagens nacionais.
  - `cotacaoBrl` number: Cotação da moeda em R$ no momento da viagem. Ex: 5.80 para USD/BRL. Necessário apenas se moedaDestino ≠ BRL.
  - `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)