> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zipdin.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Simular Empréstimo

> Simule as condições financeiras antes de formalizar o contrato

# Simular Empréstimo

Obtenha as condições financeiras (parcela, taxas, CET) para a proposta antes da formalização.

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/authentication) para obter suas credenciais e gerar um token.
</Info>

## Parâmetros

<ParamField path="nu_proposta" type="integer" required>
  Número da proposta (retornado na criação)
</ParamField>

<ParamField body="vl_emprestimo" type="number" required>
  Valor desejado
</ParamField>

<ParamField body="qt_parcela" type="integer" required>
  Quantidade de parcelas
</ParamField>

## Exemplo

```bash cURL theme={null}
curl -X POST https://api.zipdin.com.br/api/v1/propostas/789456/simular \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vl_emprestimo": 10000.00, "qt_parcela": 36}'
```

<ResponseExample>
  ```json 200 - Simulação realizada theme={null}
  {
    "vl_emprestimo": 10000.00,
    "qt_parcela": 36,
    "vl_parcela": 398.50,
    "vl_liberado": 9250.00,
    "vl_taxa_mensal": 2.49,
    "tx_cet_anual": 34.82,
    "dt_primeiro_vencimento": "2026-09-05"
  }
  ```
</ResponseExample>

<Warning>
  Valores da simulação são válidos por **24 horas**. Após esse período, simule novamente.
</Warning>