Buscar proposta

GET/v1/propostas/{id}

🔒 Requer Bearer token

Retorna os detalhes de uma proposta que você enviou, pelo id interno (cuid). Escopo: leilao:read.

Parâmetros

idstringpathobrigatório

ID interno da proposta (cuid)

Respostas

Corpo da resposta 200

idstringobrigatório

numerostringobrigatório

Número de exibição

solicitacaoIdstringobrigatório

cpfTrabalhadorstringobrigatório

nomeTrabalhadorstringobrigatório

numeroInscricaoEmpregadorstringobrigatório

Inscrição do empregador (CNPJ ou código alfanumérico).

valorstringopcionalnullable

Decimal serializado como string.

parcelastringopcionalnullable

prazoobjectopcionalnullable

taxastringopcionalnullable

Taxa mensal (% a.m.) como string.

regraobjectopcionalnullable

statusstringobrigatório

Status atual da proposta (texto normalizado em MAIÚSCULAS). Pode conter valores fora da lista quando novos status forem introduzidos.

ENVIADACONFIRMADARECUSADAVENCEDORAFINALIZADAEM_ANALISEERROERRO_ENVIO

dataHoraEnviostring<date-time>obrigatório

Instante do envio da proposta (ISO, UTC).

statusSocinalstringopcionalnullable

Status textual como recebido, sem normalização de caixa. `null` enquanto não houver retorno para a proposta.

mensagemStatusstringopcionalnullable

Mensagem/observação sobre o status da proposta. `null` enquanto não houver.

suaPontuacaonumberopcionalnullable

Pontuação da sua proposta no leilão. `null` enquanto não houver.

pontuacaoVencedoranumberopcionalnullable

Pontuação da proposta vencedora do leilão. `null` enquanto não houver.

Request

curl -X GET 'https://econsignado-api-leilao.socinal.com.br/v1/propostas/:id' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "id": "cmqb...",
  "numero": "LEI-0091",
  "solicitacaoId": "30808607",
  "cpfTrabalhador": "90191033421",
  "nomeTrabalhador": "Maria Santos",
  "numeroInscricaoEmpregador": "66106660000160",
  "valor": "14000.00",
  "parcela": "425.32",
  "prazo": 36,
  "taxa": "1.79",
  "regra": "Regra 1",
  "status": "ENVIADA",
  "dataHoraEnvio": "2026-06-12T23:10:08.205Z",
  "statusSocinal": "RECUSADA",
  "mensagemStatus": "Proposta recusada: pontuação abaixo da vencedora.",
  "suaPontuacao": 7,
  "pontuacaoVencedora": 7
}