---
title: "Calculadora de Milhas para Passagem Aérea"
method: POST
path: "/api/v1/calc/calculadora-milhas-passagem"
tags: ["calc", "financas"]
---

# Calculadora de Milhas para Passagem Aérea

`POST /api/v1/calc/calculadora-milhas-passagem`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/calculadora-milhas-passagem`
- Auth: HTTP bearer

Descubra se vale a pena usar suas milhas ou pontos de cartão para emitir passagens. Calcule o CPM (centavos por milha) e compare com comprar a passagem em dinheiro.

## Request body

- object
  - `milhasNecessarias` number, required
  - `milhasDisponiveis` number
  - `pontosCartaoDisponiveis` number
  - `taxaConversaoPontosMilha` number
  - `valorPassagemDinheiroCents` integer, required
  - `taxasEmbarqueCents` integer
  - `programaFidelidade` 'smiles' | 'tudoazul' | 'latampass' | 'outro'
  - `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)