---
title: "Simula declaração de Imposto de Renda — compara modelo simplificado vs completo e calcula imposto devido ou restituição."
method: GET
path: "/v1/calc/simulate-income-tax"
tags: ["Calculadoras"]
---

# Simula declaração de Imposto de Renda — compara modelo simplificado vs completo e calcula imposto devido ou restituição.

`GET /v1/calc/simulate-income-tax`

## Request

- Base URL: `https://api.falazuki.com`
- URL: `https://api.falazuki.com/v1/calc/simulate-income-tax`
- Auth: none declared

Sem query params, devolve o schema de entrada em vez de calcular — útil pra descobrir o endpoint pelo navegador.

## Query parameters

- `annual_income` number, required: Renda tributável anual em R$
- `tax_withheld` number: IR já retido na fonte no ano em R$
- `dependents` integer: Número de dependentes
- `health_expenses` number: Gastos com saúde no ano em R$
- `education_expenses` number: Gastos com educação no ano em R$ (limite R$ 3.561,50/pessoa)
- `pension_expenses` number: Previdência privada PGBL no ano em R$

## Response `200`

Resultado do cálculo

- object: Campos variam por calculador. `currency` está sempre presente.
  - `currency` string

## Other responses

- `400`: Entrada inválida
- `503`: Taxas indisponíveis na fonte

---

[API](https://skmtc.dev/falazuki/apis/falazuki-finance-api.md) · [All operations](https://skmtc.dev/falazuki/apis/falazuki-finance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falazuki/apis/falazuki-finance-api/revisions/ad442f36c098?raw)