> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predictus.inf.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar por Parâmetros

> Consulte processos judiciais com base em critérios diversos como assunto, valor, classe, juiz, relator, polo, julgamentos e muito mais.

# 🧪 Busca Customizada (Parâmetros Avançados)

Este endpoint permite montar consultas altamente refinadas para encontrar processos judiciais com base em **características específicas**, como:

* Partes e advogados envolvidos (ou explicitamente não envolvidos)
* Valor da causa, datas, status, classe, assuntos
* Órgãos julgadores, julgamentos, juízes, relatores e mais

***

## 🔗 Endpoint

```
POST https://api.predictus.com.br/predictus-api/processos/judiciais/buscarPorParametros
```

***

## 🧾 Corpo da requisição (exemplo completo)

> O payload é extenso e flexível. Veja abaixo um exemplo completo com múltiplos filtros aplicados:

```json theme={null}
{
  "limiteResultados": 100,
  "partes": [
    {
      "nome": "08108732905",
      "cnpj": "00000000000191",
      "raizCnpj": "12345678",
      "cpf": "08108732905",
      "polo": "ATIVO"
    }
  ],
  "naoPartes": [
    {
      "cnpj": "00000000000191",
      "polo": "PASSIVO"
    }
  ],
  "advogados": [
    {
      "nome": "08108732905",
      "oab": {
        "numero": "12345",
        "uf": "SC"
      },
      "cpf": "08108732905",
      "polo": "ATIVO"
    }
  ],
  "naoAdvogados": [
    {
      "oab": {
        "numero": "12345",
        "uf": "SC"
      },
      "polo": "PASSIVO"
    }
  ],
  "orgaosJulgadores": [
    "JUIZADO ESPECIAL",
    "VARA"
  ],
  "unidadesOrigem": [
    "JUIZADO ESPECIAL",
    "VARA"
  ],
  "tribunais": [
    "TRT-9",
    "TJ-SC"
  ],
  "valorCausa": {
    "maiorQue": 1000,
    "menorQue": 100000
  },
  "dataDistribuicao": {
    "maiorQue": "1970-01-01",
    "menorQue": "2025-02-03"
  },
  "dataArquivamento": {
    "maiorQue": "1970-01-01",
    "menorQue": "2025-02-03"
  },
  "dataTransitoJulgado": {
    "maiorQue": "1970-01-01",
    "menorQue": "2025-02-03"
  },
  "classesProcessuais": [
    "CUMPRIMENTO DE SENTENCA",
    "PROCEDIMENTO DO JUIZADO ESPECIAL CIVEL"
  ],
  "naoClassesProcessuais": [
    "ACAO TRABALHISTA - RITO ORDINARIO"
  ],
  "naoAssuntosCNJ": [
    "ADICIONAL DE HORAS EXTRAS"
  ],
  "assuntosCNJ": [
    "INDENIZACAO",
    "ATRASO DE VOO",
    "ADICIONAL DE HORAS EXTRAS",
    "DIREITO"
  ],
  "statusProcessuais": [
    "EM TRAMITACAO",
    "ARQUIVAMENTO DEFINITIVO",
    "EM GRAU DE RECURSO"
  ],
  "ramosDoDireito": [
    "DIREITO DO TRABALHO",
    "DIREITO DO CONSUMIDOR",
    "DIREITO CIVIL"
  ],
  "segmentos": [
    "JUSTICA ESTADUAL",
    "JUSTICA DO TRABALHO"
  ],
  "julgamentos": [
    "PROCEDENCIA",
    "PROCEDENCIA EM PARTE"
  ],
  "naoNumerosProcessoUnico": [
    "50091485920228240090"
  ],
  "ufs": [
    "SC",
    "PR"
  ],
  "camposRetorno": {
    "incluir": [
      "urlProcesso",
      "numeroProcessoUnico",
      "numeroProcessoAntigo",
      "statusObservacao",
      "grauProcesso",
      "juiz",
      "relator",
      "revisores",
      "area",
      "sistema",
      "segmento",
      "tribunalOrigem",
      "tribunal",
      "uf",
      "orgaoJulgador",
      "unidadeOrigem",
      "classeProcessual",
      "assuntosCNJ",
      "dataDistribuicao",
      "dataAutuacao",
      "partes",
      "advogadosSemParte",
      "processosRelacionados",
      "valorCausa",
      "valorExecucao",
      "eTutelaAntecipada",
      "temInjuncao",
      "eJusticaGratuita",
      "ePrioritario",
      "eSegredoJustica",
      "eProcessoDigital",
      "temAcordao",
      "acordao",
      "temSentenca",
      "sentenca",
      "dataProcessamento",
      "statusPredictus"
    ]
  }
}
```

***

## 📚 Campos importantes

* `partes` e `naoPartes` — lista de objetos com `cpf`, `cnpj`, `raizCnpj`, `nome`, `polo`\
  Permite incluir ou excluir partes específicas na consulta
* `advogados` e `naoAdvogados` — filtros por OAB, CPF ou nome
* `classesProcessuais`, `assuntosCNJ`, `statusProcessuais`, `ramosDoDireito`, `segmentos` — todos os filtros padronizados Predictus
* `orgaosJulgadores`, `unidadesOrigem`, `tribunais` — filtros estruturais do processo
* `valorCausa`, `dataDistribuicao`, `dataArquivamento`, `dataTransitoJulgado` — permitem busca por faixa (menorQue/menorIgualQue/maiorQue/maiorIgualQue)
* `julgamentos` — resultado da sentença (ex: "IMPROCEDENCIA", "PROCEDENCIA EM PARTE")
  * Ver [lista completa de julgamentos](../../referencias/julgamentos)
* `ufs` — siglas de estado (ex: "SP", "RJ", "SC")
* `limiteResultados` — mínimo: 1 / máximo: 10.000 (padrão: 10.000)
* `camposRetorno` — escolha os campos desejados no retorno
* `naoNumerosProcessoUnico` - excluir processos específicos no retorno

***

## 📌 Como funcionam os filtros

| Situação                                               | Comportamento                                |
| ------------------------------------------------------ | -------------------------------------------- |
| Filtros diferentes                                     | Lógica **AND** entre eles                    |
| Listas internas (ex: classes)                          | Lógica **OR** dentro do array                |
| `naoPartes`, `naoAdvogados`, `naoNumerosProcessoUnico` | Excluem registros com as condições indicadas |
| Faixas (`data`, `valor`)                               | Deve estar dentro do intervalo fornecido     |

***

## 🧾 Códigos de resposta

| Código | Significado                     |
| ------ | ------------------------------- |
| `200`  | Sucesso — processos encontrados |
| `204`  | Nenhum processo encontrado      |
| `400`  | Erro de validação no payload    |
| `401`  | Token inválido ou expirado      |

***

## 💡 Quando usar

* Estudo de jurisprudência
* Análise de padrões de decisão
* Filtragem de massa com múltiplas variáveis
* Diagnóstico jurídico por perfil de risco ou estratégia

***

## 🧾 Retorno

Retorna uma lista de objetos do tipo [`processo`](../estrutura), com todos os campos solicitados em `camposRetorno`.