Nos últimos anos, fui acompanhando uma transformação silenciosa no setor jurídico, onde o acesso digital a processos não é mais privilégio de poucos, mas uma necessidade para empresas e escritórios. Entre as soluções que mais me chamaram atenção, a busca processual via API tem simplificado como nunca a consulta de processos em diversos tribunais. No Brasil, vejo que a Judit se destacou por conectar mais de 90 tribunais e tornar todo esse universo acessível em apenas alguns cliques ou integrações.
Entendendo a lógica da busca processual via API
Antes de mais nada, é importante entender o que realmente acontece nos bastidores de uma busca processual via API. Ao integrar sistemas da sua empresa ou do seu escritório jurídico à API da Judit, você ganha a possibilidade de consultar, analisar e monitorar processos judiciais de forma automática e em tempo real. Mas como montar uma solicitação correta? É isso que explico a seguir.
“A precisão começa pelo preenchimento correto dos campos na solicitação.”
Sempre recomendo que os desenvolvedores foquem em dois campos obrigatórios para realizar uma consulta de processo judicial:
- search_type: Use sempre “lawsuit_cnj” quando o objetivo for consultar um processo usando o número do CNJ.
- search_key: Aqui você deve informar o número do processo no formato do Código CNJ. Sem isso, a busca não avança.
Sem esses campos, não há consulta possível.
Campos opcionais: personalizando sua consulta
Além dos campos essenciais, a API da Judit permite ajustar sua busca processual com parâmetros opcionais. Essa personalização faz toda a diferença e, em minha opinião, pode poupar muito tempo e garantir consultas mais certeiras:
- cache_ttl_in_days: Indique aqui, se quiser, quantos dias a API pode aceitar uma resposta em cache. É ótimo para buscas recorrentes em processos pouco alterados.
- with_attachments: Escolha true se quiser trazer anexos (como decisões, sentenças, ou petições) junto com o resultado, ou false se não precisar de anexos. Isso é fundamental para quem necessita acessar documentos completos diretamente da resposta.
- lawsuit_instance: Se você precisa de dados apenas de uma instância específica do processo (como primeira ou segunda instância), é aqui que você informa.
- masked_response: Essa opção reduz a resposta à essência, trazendo menos dados identificáveis, usada somente em consultas por documento. Ótimo para cenários que exigem sigilo.
- judit-ia: Com esse campo, dá para pedir serviços como summary (resumo automático dos autos), aumentando o valor informativo da consulta.
Como acompanhar o processamento da busca?
Quando faço testes ou implemento para clientes, sempre oriento: as respostas da API Judit chegam de forma incremental, porque cada tribunal pode responder em um tempo diferente. Por isso, você tem de monitorar o status do pedido pelo campo request_status.
- completed: Consulta finalizada e todos os tribunais responderam.
- outros valores (como pending ou running): A busca ainda está em andamento. Sempre aguardo o status “completed” para confiar nos dados finais.
“Só considere os dados completos quando o status for ‘completed’.”
Estrutura da resposta: como entender o que chega?
A primeira vez que vi uma resposta da Judit, fiquei impressionado com a clareza na estrutura. Tudo o que é retornado de dados da consulta aparece em um array chamado page_data. Cada objeto ali dentro é uma instância: se o processo correu por mais de uma etapa, cada etapa vem separada.
Veja um exemplo simplificado:
{ "request_status": "completed", "page_data": [ { "lawsuit_instance": "primeira_instancia", "movements": [...], "attachments": [...] }, { "lawsuit_instance": "segunda_instancia", "movements": [...], "attachments": [...] } ]}
Na prática do dia a dia, gosto de buscar detalhes em cada objeto de page_data, onde estão não só os movimentos, mas também dados cadastrais e anexos específicos daquela instância.
Respostas incrementais e o acompanhamento em tempo real
Percebi, na prática, que como a API faz consultas a diversos tribunais simultaneamente, os dados chegam aos poucos. Por isso, criei o hábito de consultar o endpoint várias vezes ou implementar um sistema de polling até que o status “completed” retorne. Essa dinâmica é comum para quem trabalha com automação jurídica e deseja sempre respostas atualizadas.
Se quiser se aprofundar nesse tipo de implementação, já escrevi ou recomendei leituras completas sobre automação jurídica em artigos sobre automação jurídica e posso garantir que o acompanhamento incremental é o caminho mais seguro.
Como funciona a consulta de anexos?
Muitos me perguntam: “Como sei se os anexos vieram corretamente?”. Na resposta de cada instância do processo, há uma chave attachments com um array de todos os documentos. Para cada anexo:
- status: Indica o resultado da captura. Quando está “done”, foi obtido com sucesso. Se houve erro ou restrição, verá outro status.
- private: Se algum anexo for privado no tribunal, esse campo será true. É o caso de documentos sigilosos.
- extension: Indica o formato do documento: pode ser pdf, jpg, docx, entre outros. Acho prático para automatizar o tratamento dos arquivos.
Na minha rotina, costumo programar checagens desse array para baixar apenas o que importa ou alertar a equipe sobre anexos privados.
Exemplo: análise automatizada com Judit IA
Quando quero dar ainda mais valor à extração de dados do processo, adiciono o campo judit-ia na requisição, usando o valor “summary”. O resultado é surpreendente: recebo um resumo objetivo do processo, salvo na chave judit_ia_analysis dentro do objeto da instância correspondente. Recebi, por exemplo:
"judit_ia_analysis": { "summary": "Ação de cobrança ajuizada por ABC contra DEF. Sentença favorável ao autor e cumprimento de sentença em andamento."}
Isso poupa um tempo enorme, principalmente em análises de risco ou triagens de crédito. Em vez de ler várias páginas, consulto o resumo e sigo com decisões rápidas.
Como integrar a busca processual ao seu negócio?
Não sou só entusiasta, mas espectador atento do impacto da automação jurídica. Para saber mais sobre esse universo e acompanhar tendências de uso das APIs, recomendo acessar conteúdos na categoria de API do blog Judit e também a área de gestão jurídica. Também é válido testar exemplos e conteúdos específicos, como esse case prático.
Como testar consultas na prática?
Se chegou até aqui, provavelmente já quer experimentar a plataforma e validar tudo o que expliquei. O próprio blog oferece uma ferramenta de busca processual real para você ver a API trabalhando (acesse aqui).
Conclusão
A busca processual via API mudou minha percepção sobre como lidar com grandes volumes de processos jurídicos. Ao personalizar as consultas, monitorar o status e explorar recursos como anexos e análises automáticas com IA, tudo fica mais simples, rápido e confiável.
Se você sente que é hora de transformar a gestão dos processos do seu negócio, recomendo criar sua conta na Judit para testar as soluções disponíveis e experimentar essas vantagens por conta própria. Integre inteligência jurídica agora mesmo à sua rotina!
Perguntas frequentes sobre busca processual via API
O que é a busca processual via API?
A busca processual via API é uma forma automatizada de consultar informações sobre processos judiciais diretamente em sistemas, sem precisar acessar manualmente os portais dos tribunais. Com a API da Judit, você pode integrar essa busca ao seu sistema, obtendo dados atualizados, detalhados e, caso deseje, anexos e análises automáticas com inteligência artificial.
Como funciona a integração da API Judit?
A integração é simples: você precisa apenas de um token de acesso gerado no painel Judit e seguir a documentação, definindo os campos obrigatórios (como search_type e search_key) e opcionais, conforme sua necessidade. Os dados são recebidos de maneira padronizada e incremental, garantindo consultas automáticas e integração total com outros sistemas de gestão.
Quais informações posso buscar na API Judit?
A API Judit permite acessar dados completos de processos judiciais, como movimentos processuais, dados cadastrais das partes, instâncias, anexos do processo (decisões, documentos, etc) e até resumos automáticos com Judit IA. É possível também configurar a busca para trazer apenas dados de interesse ou cuidar da privacidade de informações sensíveis.
É seguro usar a busca processual por API?
Sim, a Judit adota padrões de segurança atuais e mantém a privacidade dos dados acessados, respeitando regras dos órgãos oficiais e assegurando conexões protegidas via HTTPS. Além disso, os dados sensíveis podem ser mascarados pela opção masked_response.
Quanto custa acessar a API da Judit?
Os valores para acesso à API Judit variam conforme o volume e os serviços contratados. É possível iniciar com um teste gratuito para entender como funciona na prática. Para detalhes completos e planos, vale cadastrar-se na plataforma e avaliar as opções disponíveis.
