Listar propostas

GET/v1/propostas

🔒 Requer Bearer token

Lista as propostas que você enviou. Filtro opcional por status. Escopo: leilao:read.

Parâmetros

statusstringqueryopcional

Filtra as propostas pelo status (case-insensitive; aceita valores fora da lista conhecida).

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?status=valor' \
  -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
  }
]