---
title: "Calculadora de IPVA 2026"
method: POST
path: "/api/v1/calc/ipva"
tags: ["calc", "veiculos"]
---

# Calculadora de IPVA 2026

`POST /api/v1/calc/ipva`

## Request

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

Calcule o IPVA do seu veículo usando valor FIPE + alíquota do seu estado. Inclui desconto à vista.

## Request body

- object
  - `valorFipeCents` integer, required: Valor do veículo na tabela FIPE em centavos. Ex: R$ 50.000 → 5000000
  - `estado` 'AC' | 'AL' | 'AM' | 'AP' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MG' | 'MS' | 'MT' | 'PA' | 'PB' | 'PE' | 'PI' | 'PR' | 'RJ' | 'RN' | 'RO' | 'RR' | 'RS' | 'SC' | 'SE' | 'SP' | 'TO' | 'outros', required: Estado de emplacamento do veículo (27 UFs cobertas + "outros" como fallback). Alíquotas auto/moto principais 2026: SP 4%/2%; RJ 4%/2%; MG 4%/2%; PR 3,5%/2%; SC 2%/2%; RS 3%/2%; BA 2,5%/2%; DF 3,5%/2%. As demais 19 UFs e "outros" usam alíquotas específicas da SEFAZ estadual via utilitário `ipva-estados.ts`. Tabela versionada `IPVA_TABELA_YM` 2026-01.
  - `tipo` 'auto' | 'moto' | 'caminhao' | 'utilitario', required: Tipo do veículo. "auto" = carro de passeio; "moto" = motocicleta (alíquota geralmente metade da do auto); "caminhao" = veículo de carga (1–1,5%); "utilitario" = van e similares.
  - `descontoAVistaPercent` number: Percentual de desconto concedido pelo estado para pagamento à vista em janeiro. Em % (ex: 3 = 3%). Varia por estado: SP e RJ 3%, PR até 5%.
  - `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)