Consultar status

GET/v1/solicitacoes/{id}/status

🔒 Requer Bearer token

Consulta o status atual de uma proposta que você enviou e devolve os dados atualizados (PropostaDto + mensagemStatus). Retorna 404 se ainda não houver proposta sua para essa solicitação. Escopo: leilao:read.

Parâmetros

idstringpathobrigatório

ID da solicitação de leilão

ImpersonateUserstringheaderopcional

Identificação do parceiro na Socinal. **Não precisa ser enviado**: o valor é lido do claim `id_parceiro_socinal` do token. Aceito apenas como fallback para tokens emitidos antes do claim; quando enviado junto com um token que tem o claim, o claim prevalece.

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.

motivoRecusastringopcionalnullable

Motivo da recusa quando a Socinal rejeitou o envio na hora (HTTP 4xx em `enviar-proposta`), com `status = RECUSADA`. `null` nos demais casos — a recusa que chega depois, por webhook, vem em `mensagemStatus`.

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/solicitacoes/:id/status' \
  -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.",
  "motivoRecusa": "HTTP 422: VL — valor da parcela acima da margem",
  "suaPontuacao": 7,
  "pontuacaoVencedora": 7
}