---
title: "Depreciação de Veículo — Quanto seu Carro Perde de Valor por Ano"
method: POST
path: "/api/v1/calc/depreciacao-veiculo"
tags: ["calc", "veiculos"]
---

# Depreciação de Veículo — Quanto seu Carro Perde de Valor por Ano

`POST /api/v1/calc/depreciacao-veiculo`

## Request

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

Calcule quanto seu veículo perde de valor ao longo do tempo. Compare a depreciação exponencial (realista) com a linear e projete o valor de revenda para os próximos anos.

## Request body

- object
  - `valorAtualCents` integer, required: Valor de mercado atual do veículo em centavos (referência FIPE ou nota fiscal). Ex: R$ 50.000 → 5000000
  - `tipoVeiculo` 'carro_popular' | 'carro_medio' | 'carro_premium' | 'caminhonete' | 'moto', required: Categoria do veículo, usada para determinar a taxa de depreciação padrão. "carro_popular" = modelos de até R$ 80k (deprecia ~12–15%/ano); "carro_medio" = R$ 80k–150k (~10–12%/ano); "carro_premium" = acima de R$ 150k (~8–10%/ano); "caminhonete" = picapes, menor depreciação (~8–10%/ano); "moto" = motocicletas (~15–18%/ano).
  - `anoFabricacao` integer, required: Ano de fabricação do veículo. Usado para calcular quantos anos de depreciação já ocorreram. Entre 1990 e 2026.
  - `taxaDepreciacaoAnualPercentOverride` number: Taxa de depreciação anual personalizada em % ao ano. Quando informada, substitui a taxa padrão do tipo de veículo. Ex: 10 = 10% a.a. Deixe em branco para usar a taxa padrão da categoria.
  - `modeloDepreciacao` 'exponencial' | 'linear': Fórmula de cálculo da depreciação. "exponencial" = aplica a taxa sobre o valor atual a cada ano (mais realista, perda maior nos primeiros anos); "linear" = aplica a taxa sobre o valor original (perda constante a cada ano).
  - `anosFuturos` integer: Número de anos futuros a projetar a partir do valor atual. Mínimo 1 ano, máximo 20 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)