Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.judit.io/llms.txt

Use this file to discover all available pages before exploring further.

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 de Quantidade retorna apenas o total de processos no datalake da Judit que correspondem aos critérios informados. Sem listar processos, sem paginação — só o número. Perfeita para dashboards, scoring de risco e tomadas de decisão baseadas em volume.
🤖 Endpoint: POST https://lawsuits.production.judit.io/lawsuits/count. A resposta é síncrona (HTTP 200 com { "total": <number> }) e suporta o mesmo objeto de filtros da Consulta Hot Storage — tribunal, polo, classes, assuntos, valor da causa, datas etc.

​
Quando usar

Score e tiering de risco

”≥ 5 processos trabalhistas no passivo nos últimos 3 anos = risco alto.” Em uma chamada.

Dashboards de portfólio

Quantos processos cada cliente do portfólio acumula? Pingue todos com chamadas paralelas em milissegundos.

Limites de exposição

Decida limites de crédito ou apólices com base na contagem de processos por classe.

Pré-checagem antes do Hot Storage

Saber que o resultado é “0” antes de pedir uma lista completa economiza pagamento de payload.
Para apenas saber se existe processo (booleano), use POST /lawsuits com page_size: 1. Para a lista completa de processos, use POST /lawsuits (Hot Storage).

​
Passo 1: Criar a Consulta (POST)

POST https://lawsuits.production.judit.io/lawsuits/count

​
Exemplos de payload

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99"
    }
}

​
Parâmetros do payload

ParâmetroTipoObrigatórioDescrição
search.search_typestringSimcpf, cnpj, oab, name, lawsuit_cnj ou rji.
search.search_keystringSimDocumento ou nome a contar.
search.response_typestringSimUse "lawsuits".
search.search_params.filterobjectNãoFiltros (mesma estrutura do Hot Storage).

​
Filtros suportados (search_params.filter)

FiltroTipoComportamento
sideenumActive, Passive, Interested, Unknown.
party_namesstring[]Filtro por nome exato da parte.
party_documentsstring[]Filtro por CPF/CNPJ da parte.
FiltroTipoComportamento
distribution_date_gte / _ltedatetimeJanela de distribuição.
last_step_date_gte / _ltedatetimeJanela de última movimentação.
FiltroTipoComportamento
tribunals{ keys, not_equal }Inclui (false) ou exclui (true) os tribunais. Lista em Cobertura.
classification_codes / classification_names{ keys, not_equal }Códigos/nomes oficiais de classe (CNJ).
subject_codes / subject_names{ contains, not_contains }Códigos/nomes oficiais de assunto (CNJ).
FiltroTipoComportamento
amount_gtenumberValor mínimo da causa.
amount_ltenumberValor máximo da causa.
Os campos state e secrecy_level aparecem somente na resposta — não funcionam como filtros de entrada nessa rota. Para filtrar por sigilo, use secrecy_level no objeto retornado pelo Hot Storage.

​
Exemplo de requisição

curl -X POST 'https://lawsuits.production.judit.io/lawsuits/count' \
  --header 'api-key: '"$JUDIT_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "search": {
      "search_type": "cpf",
      "search_key": "999.999.999-99
    }
  }'

​
Passo 2: Ler a resposta

Resposta
{
    "total": 12
}
CampoTipoDescrição
totalnumberQuantidade de processos que correspondem aos filtros.
Sem filtros, o total traz todos os processos do datalake vinculados ao documento/nome consultado. Aplique filtros para tier por categoria (ex.: “trabalhistas no passivo”, “cíveis com valor acima de R$ 100k”).

​
Padrões e dicas

Para portfólios grandes, dispare chamadas em paralelo (10-50 simultâneas) — a rota é síncrona e leve. Respeite os limites do seu plano.
Quer mais que o número total? Combine com POST /lawsuits/synthetic para receber buckets por tribunal, classe, fase, polo, etc. — também síncrono.
Defina thresholds (>= 5 processos = tier alto) no seu lado e passe filtros granulares ao endpoint para refinar. Por exemplo, contar só trabalhistas para um pré-emprego, ou só cíveis com valor acima de R$ 50k para crédito.
Cacheie o total por (documento, hash dos filtros). Atualize a cada N horas conforme criticidade. Se precisar de dados frescos do tribunal, use POST /requests.

​
Próximos passos