Skip to main content

🔎 Buscar por Nome ou Razão Social Exato (Advogado)

Este endpoint permite consultar todos os processos em que um determinado nome exato esteja envolvido como advogado ativo, passivo ou outros. Você pode aplicar filtros por grau, tribunal, classe, assunto, valor da causa, status, ramo do direito e mais.

🔗 Endpoint


🧾 Exemplo mínimo

nome é o único campo obrigatório. Todos os demais são filtros opcionais.

🧾 Exemplo completo (com todos os filtros)

📚 Campos importantes

  • nome (string) — único campo obrigatório
    • Pode ser nome completo ou parcial
  • semDocumento (boolean) — opcional
    • Quando true, retorna apenas processos em que o advogado não possui CPF ou CNPJ identificado
  • polo — ATIVO ou PASSIVO
  • grausProcesso — lista de inteiros entre 1 e 4:
    • 1 → 1º Grau (ex: vara cível)
    • 2 → 2º Grau (tribunais estaduais/regionais)
    • 3 → Tribunais Superiores (STJ, TST etc.)
    • 4 → Supremo Tribunal Federal (STF)
  • tribunais — lista de siglas válidas (ex: TJ-SP, TRT-9, STF)
  • valorCausa — faixa sobre o valor da causa (valorCausa.valor) (menorQue/menorIgualQue/maiorQue/maiorIgualQue). Considera somente o valor da causa: processo sem valor da causa não entra quando este filtro é usado.
  • valorExecucao — faixa sobre o valor de execução fixado na decisão (statusPredictus.valorExecucao.valor), no mesmo formato de valorCausa. Usado junto com valorCausa, o processo precisa atender aos dois.
  • dataDistribuicao — permite filtragem por faixa (menorQue/menorIgualQue/maiorQue/maiorIgualQue)
  • classesProcessuais, assuntosCNJ — até 65.000 valores cada
  • statusProcessuais — veja valores válidos
  • ramosDoDireito — veja valores válidos
  • segmentos — deve conter apenas valores válidos (ex: JUSTICA DO TRABALHO, STF)
  • limiteResultados — mínimo: 1 / máximo: 10.000 (padrão: 10.000)

📌 Como funcionam os filtros

A API aplica os filtros com lógica combinada (AND entre filtros diferentes, OR dentro de listas):

🧾 Códigos de resposta


🛡️ Validações aplicadas

  • Nome:
    • Não pode ser nulo ou vazio
  • Polo:
    • ATIVO ou PASSIVO
  • Lista de statusProcessuais, ramosDoDireito, segmentos, tribunais:
    • Todos os valores devem estar na lista de permitidos
  • Campos com listas extensas (classesProcessuais, assuntosCNJ):
    • Máximo de 65.000 itens
  • limiteResultados: entre 1 e 10.000

🧾 Retorno

Retorna uma lista de objetos do tipo processo, com dados estruturados e padronizados pela Predictus.