---
title: "Projeta quando e com quanto a pessoa se aposenta por idade pela EC 103/2019: idade mínima, tempo mínimo (que depende de a filiação ser anterior ou posterior a 13/11/2019), percentual da média e o piso de um salário mínimo."
method: GET
path: "/v1/calc/retirement"
tags: ["Calculadoras"]
---

# Projeta quando e com quanto a pessoa se aposenta por idade pela EC 103/2019: idade mínima, tempo mínimo (que depende de a filiação ser anterior ou posterior a 13/11/2019), percentual da média e o piso de um salário mínimo.

`GET /v1/calc/retirement`

## Request

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

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

## Query parameters

- `gender` 'male' | 'female', required: Define idade e tempo mínimos: 65 anos para homem e 62 para mulher; tempo mínimo conforme affiliated_before_reform.
- `affiliated_before_reform` boolean: Já era filiado ao INSS em 13/11/2019. Verdadeiro aplica a transição por idade (EC 103/2019, art. 18): 15 anos de contribuição para homem e mulher. Falso aplica o art. 19: 20 anos para homem, 15 para mulher.
- `current_age` number, required: Idade hoje, em anos
- `contribution_years` number, required: Tempo já contribuído, em anos
- `average_salary` number, required: Salário usado como proxy da média das contribuições, em R$. O cálculo real usa a média de todo o histórico desde julho de 1994.

## 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)