Consultar regras de filtragem do leilão

GET/v1/regras-leilao

🔒 Requer Bearer token

Escopo regras:read. Devolve as regras de filtragem **vigentes** do parceiro do token — até 3 regras, cada uma com N condições combinadas em **AND** (entre regras também é AND). Destinado à API de Leilão, que aplica o filtro sobre a listagem de solicitações.

O dono das regras é resolvido **exclusivamente** pelo claim parceiro_id do token: não há parâmetro de parceiro.

versao: 0 com regras: [] significa **"não filtra nada"** — nunca "filtra tudo". Um parceiro sem regras publicadas deve continuar vendo o pool íntegro.

Datas em ISO-8601 UTC. A resposta é sempre fresca (sem cache na v1), portanto publicar uma regra passa a valer na chamada seguinte.

Respostas

Corpo da resposta 200

parceiro_idstring<uuid>obrigatório

versaonumberobrigatório

publicada_emstring<date-time>obrigatório

regrasarray<object>obrigatório

ordemnumberobrigatório

nomestringobrigatório

condicoesarray<object>obrigatório

campostringobrigatório

operadorstringobrigatório

valorobjectobrigatório

igualbooleanobrigatório

Request

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

Response

{
  "parceiro_id": "3f2a8c1e-9b4d-4a7f-8e21-5c6d7b8a9f01",
  "versao": 7,
  "publicada_em": "2026-08-17T13:40:22.118Z",
  "regras": [
    {
      "ordem": 1,
      "nome": "CLT consolidado",
      "condicoes": [
        {
          "campo": "elegivel_emprestimo",
          "operador": "igual",
          "valor": {
            "igual": true
          }
        },
        {
          "campo": "tempo_admissao",
          "operador": "maior_igual",
          "valor": {
            "min": 6
          }
        },
        {
          "campo": "valor_liberado",
          "operador": "entre",
          "valor": {
            "min": 3000,
            "max": 40000
          }
        }
      ]
    },
    {
      "ordem": 2,
      "nome": "Sem PEP",
      "condicoes": [
        {
          "campo": "pep",
          "operador": "igual",
          "valor": {
            "igual": false
          }
        }
      ]
    },
    {
      "ordem": 3,
      "nome": "Atividades permitidas",
      "condicoes": [
        {
          "campo": "cnae_divisao",
          "operador": "excluir",
          "valor": {
            "lista": [
              "92",
              "99"
            ]
          }
        }
      ]
    }
  ]
}