A consulta de processos oferece dois caminhos complementares. A base consolidada é indicada para cobertura, histórico e volume. O modo tempo real tenta atualizar dados diretamente no sistema público compatível no momento da solicitação.

​
Quando usar cada modo

realtime=true não significa cobertura nacional. Ele significa que a Sherlocker tentou as fontes compatíveis e informa no job o que foi consultado, concluído, parcial ou bloqueado.

​
Consulta por CPF ou CNPJ

Sem realtime, a resposta vem somente da base consolidada. Com ?realtime=true, a resposta mantém os processos já conhecidos e adiciona um job para descoberta e atualização:
O realtime por documento tenta hoje a descoberta em sete TJs estaduais com consulta e-SAJ por CPF/CNPJ: TJAC, TJAL, TJAM, TJBA, TJCE, TJMS e TJSP. A obtenção de detalhes é mais restrita: há consulta compatível para TJAL, TJAM, TJCE e TJSP; os demais podem devolver descoberta parcial ou não disponibilizar os detalhes necessários. Esse fluxo não equivale a uma consulta direta completa em todos os 27 TJs, nem cobre diretamente TRFs, TRTs, tribunais superiores, justiça eleitoral ou militar por documento. Publicações do PJe/DJEN podem complementar a descoberta por nome, mas não substituem uma busca integral no acervo de cada tribunal.

​
Consulta por número

Sem realtime, a rota lê o processo já indexado. Com realtime=true, ela devolve o estado atual da base e inicia um job no tribunal inferido do número CNJ. Consulte o poll_url até o estado terminal.
O número CNJ identifica ramo, tribunal e unidade de origem, mas isso não garante que o respectivo tribunal disponibilize uma consulta pública compatível. Quando a consulta em tempo real não estiver disponível, a própria resposta informa realtime.status: "unsupported" e nenhum job é criado. A Sherlocker não consulta outro tribunal como substituto.

​
Como interpretar cobertura

O job distingue:
  • complete: as etapas previstas para aquela fonte terminaram;
  • partial: houve resultado, mas uma ou mais fontes ou detalhes falharam;
  • failed: nenhuma resposta utilizável foi produzida;
  • result_total_is_final: indica se a lista canônica deixou de crescer.
Um job concluído significa execução concluída dentro da cobertura declarada, e não “nenhum outro processo existe no Brasil”.

​
Por que não existe uma única busca oficial nacional por parte

A API Pública do DataJud é organizada por aliases de tribunais e oferece metadados processuais; ela não é um resolvedor nacional público de CPF/CNPJ para partes. Já o PJe Comunica publica comunicações processuais e destinatários, que podem trazer o nome sem expor o documento. Na prática, o dado disponível depende do sistema de origem, do grau, do tipo de publicação, do nível de sigilo e da forma como o processo foi cadastrado. Por isso, cobertura, vínculo e atualidade são dimensões separadas na resposta.