Consultar Status da Proposta
curl --request GET \
--url https://api.example.com/api/v1/propostas/{nu_proposta} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/propostas/{nu_proposta}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/propostas/{nu_proposta}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
}
Propostas
Consultar Status da Proposta
Acompanhe o andamento de uma proposta de consignado
GET
/
api
/
v1
/
propostas
/
{nu_proposta}
Consultar Status da Proposta
curl --request GET \
--url https://api.example.com/api/v1/propostas/{nu_proposta} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/propostas/{nu_proposta}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/propostas/{nu_proposta}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
}
Consultar Status
Consulte o status atual e os dados de uma proposta.Todos os endpoints requerem autenticação via Bearer token no header
Authorization.
Consulte o guia de autenticação para obter suas credenciais e gerar um token.Parâmetros
integer
required
Número da proposta
Exemplo
cURL
curl "https://api.zipdin.com.br/api/v1/propostas/789456" \
-H "Authorization: Bearer SEU_TOKEN"
{
"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"
}
Status da Proposta
O ciclo de vida de uma proposta segue o fluxo abaixo: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) |