Skip to main content
Novo CNPJ (IN 2229/24)A Judit já aceita o novo formato de CNPJ alfanumérico em conformidade com a Instrução Normativa RFB nº 2229/2024.
  • Zero esforço: nenhuma alteração é necessária na sua integração.
  • Ambiente de teste: utilize o documento A1B2C3D4/E5F6-68 para validar o fluxo e receber um processo fictício de resposta.
A Consulta Síncrona ao Hot Storage retorna, em milissegundos, todos os processos do nosso datalake vinculados a um CPF, CNPJ, OAB, Nome ou CNJ. Não há fila nem espera por tribunal: a resposta vem direto do cache JUDIT.
🤖 Endpoint: POST https://lawsuits.production.judit.io/lawsuits. A resposta é síncrona (HTTP 200 com o JSON pronto). Esta rota não vai ao tribunal — ela lê o datalake da Judit, então pode haver um pequeno atraso em relação ao estado mais atual do processo. Se precisar de dados atualizados em tempo real, use POST /requests (assíncrono).
Buscando por número de processo (CNJ)?Esta rota é recomendada para descoberta por CPF, CNPJ, OAB ou Nome. Para consultas por número de processo (CNJ), o dado no datalake pode estar desatualizado — ou o processo pode nem existir ainda em nossa base. Use a Consulta On-Demand para garantir atualização em tempo real no tribunal sem sair do fluxo síncrono.

Síncrono vs. assíncrono — qual escolher?

Quando usar

Validação em tempo real

Onboarding, KYC, autocomplete — sempre que precisar de uma resposta imediata para a UI.

Dashboards interativos

Dashboards e BI que listam processos vinculados a um cliente sem precisar atualizar o tribunal.

Pré-filtragem de risco

Antes de disparar uma consulta assíncrona cara, descubra rapidamente se vale a pena.

Estatísticas e contagens

Combine com /lawsuits/count e /lawsuits/synthetic para análises agregadas.
Todas as consultas síncronas aceitam filtros (tribunal, valor da causa, classes, partes, datas, fase). Veja a lista completa em filtros da consulta histórica — o mesmo objeto search_params.filter se aplica aqui.

Passo 1: Criar a Consulta Síncrona (POST)

Para iniciar a consulta síncrona, faça uma requisição POST enviando o documento desejado. POST https://lawsuits.production.judit.io/lawsuits

Exemplos de consultas síncronas

Ao realizar consultas por nome, é possível que existam homônimos. Sempre que possível, prefira CPF, CNPJ ou OAB para garantir maior precisão.

Parâmetros do Payload

Filtros mais comuns (search_params.filter)

A consulta síncrona aceita os mesmos filtros da consulta histórica. Veja exemplos práticos:
Lista completa de tribunais aceitos: veja Filtros da consulta histórica.

Exemplo de Requisição (POST)

Passo 2: Ler a resposta

A resposta vem no corpo do mesmo POST (não há polling). Os campos principais:

Exemplo completo de resposta

A resposta dessa requisição será um objeto JSON com os dados retornados:
Estrutura completa de cada item do array response_data: veja Schema Lawsuit.

Erros comuns

Próximos passos