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-68para validar o fluxo e receber um processo fictício de resposta.
🤖 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).
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.Passo 1: Criar a Consulta Síncrona (POST)
Para iniciar a consulta síncrona, faça uma requisiçãoPOST enviando o documento desejado.
POST https://lawsuits.production.judit.io/lawsuits
Exemplos de consultas síncronas
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
Ver exemplo de resposta
Ver exemplo 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
- Para consultar um processo específico por CNJ com garantia de atualização: Consulta On-Demand.
- Para listar e filtrar com mais profundidade (filtros avançados, polo, classes): Consulta Histórica por documento.
- Para agregação (contagens por tribunal/área/fase): Consulta Agrupada.
- Para forçar leitura em tempo real no tribunal: Consulta Assíncrona.