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

# Consultar Status da Proposta

> Acompanhe o andamento de uma proposta de consignado

# Consultar Status

Consulte o status atual e os dados de uma proposta.

<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
</ParamField>

## Exemplo

```bash cURL theme={null}
curl "https://api.zipdin.com.br/api/v1/propostas/789456" \
  -H "Authorization: Bearer SEU_TOKEN"
```

<ResponseExample>
  ```json 200 - Proposta encontrada theme={null}
  {
    "nu_proposta": 789456,
    "no_cliente": "João da Silva",
    "status": "averbada",
    "vl_emprestimo": 10000.00,
    "qt_parcela": 36,
    "vl_parcela": 398.50,
    "etapa_atual": "formalizacao",
    "dt_criacao": "2026-08-06T10:30:00-03:00",
    "dt_ultima_atualizacao": "2026-08-06T14:00:00-03:00"
  }
  ```
</ResponseExample>

## Status da Proposta

O ciclo de vida de uma proposta segue o fluxo abaixo:

```mermaid theme={null}
graph LR
    A[em_analise] --> B[pre_aprovada]
    B --> C[aprovada]
    C --> D[averbada]
    D --> E[efetivada]
    E --> F[paga]
    B --> G[negada]
    C --> G
    A --> H[cancelada]
    B --> H
    C --> H
```

### Tabela de Status

| Código | Status         | Descrição                                        |
| :----: | -------------- | ------------------------------------------------ |
|    1   | `em_analise`   | Proposta criada, análise de crédito em andamento |
|    2   | `pre_aprovada` | Análise de crédito aprovada                      |
|    3   | `aprovada`     | Proposta aprovada para formalização              |
|    4   | `averbada`     | Margem reservada na conveniada                   |
|    5   | `efetivada`    | Contrato registrado no banco                     |
|    6   | `paga`         | Valor liberado ao cliente                        |
|    7   | `negada`       | Proposta recusada (crédito, margem, etc.)        |
|    8   | `cancelada`    | Proposta cancelada (manual ou automático)        |

Cada mudança de status dispara o [webhook](/guides/webhooks) correspondente.