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 Agrupada (Synthetic) entrega, em uma única chamada síncrona, um resumo estatístico de todos os processos vinculados a um documento, agrupado por classe, assunto, área, tribunal, justiça, fase, estado, instância, lado da parte e tipo de pessoa. Use quando o cliente precisa de visão geral, não da lista completa.
🤖 Endpoint: POST https://lawsuits.production.judit.io/lawsuits/synthetic. Resposta síncrona com contagens agregadas. Para listar os processos individualmente, use POST /lawsuits (Hot Storage). Para apenas saber se existem processos (true/false) ou contar, use POST /lawsuits/count.

​
Quando usar

Dashboards executivos

Painéis de exposição judicial: contagens por tribunal, fase, instância, área — sem precisar listar cada processo.

Análise de risco rápida

Em onboarding ou crédito: descubra em ms o perfil judicial de uma contraparte (cível vs. trabalhista vs. tributário).

Pré-segmentação

Antes de decidir entre consulta detalhada ou amostral, veja o tamanho e a distribuição do conjunto.

Reports periódicos

Relatórios semanais/mensais agregados por carteira sem trafegar grandes volumes de processos.

​
Passo 1: Criar a Consulta Agrupada (POST)

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

​
Exemplos por tipo de documento

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

​
Parâmetros do Payload

ParâmetroTipoObrigatórioDescrição
search.search_typestringSim"cpf", "cnpj", "oab" ou "name".
search.search_keystringSimValor a ser buscado.
search.search_params.filterobjectNãoFiltros estruturais — mesma estrutura da consulta histórica.

​
Exemplos com filtros

{
    "search": {
        "search_type": "cnpj",
        "search_key": "00.000.000/0001-00",
        "search_params": {
            "filter": {
                "side": "Passive",
                "tribunals": { "keys": ["TJSP","TRT2"], "not_equal": false },
                "amount_gte": 50000
            }
        }
    }
}

​
Exemplo de Requisição (POST)

curl --request POST \
  --url 'https://lawsuits.production.judit.io/lawsuits/synthetic' \
  --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

A resposta é síncrona (HTTP 200) e agrega o universo encontrado em vários eixos. lawsuits_count é o total geral; cada eixo é um array { count, value }.
EixoO que agrupa
classificationsClasses processuais (ex.: PROCEDIMENTO COMUM CÍVEL).
subjectsAssuntos processuais (ex.: ACIDENTE DE TRÂNSITO).
areasÁreas do direito (ex.: DIREITO CIVIL).
tribunalsSiglas dos tribunais (ex.: TJSP, TRT1).
justicesJustiça (Estadual, Federal, etc.).
phasesFase processual atual.
statesUF onde tramita.
instancesInstância (1 ou 2).
sidesPolo da parte buscada (PASSIVE, ACTIVE, INTERESTED).
person_typesTipo da parte (REQUERENTE, AUTOR, RÉU, etc.).
lawsuits_countTotal geral de processos do universo.

​
Exemplo de resposta

{
    "classifications": [
        { "count": 1, "value": "PROCEDIMENTO COMUM CÍVEL" },
        { "count": 1, "value": "HOMOLOGAÇÃO DE TRANSAÇÃO EXTRAJUDICIAL" },
        { "count": 1, "value": "PROCEDIMENTO DO JUIZADO ESPECIAL CÍVEL" }
    ],
    "subjects": [
        { "count": 1, "value": "ÔNUS DA PROVA" },
        { "count": 1, "value": "ACIDENTE DE TRÂNSITO" },
        { "count": 1, "value": "COISAS" }
    ],
    "areas": [
        { "count": 4, "value": "DIREITO CIVIL" },
        { "count": 2, "value": "DIREITO ADMINISTRATIVO E OUTRAS MATÉRIAS DE DIREITO PÚBLICO" }
    ],
    "tribunals": [
        { "count": 1, "value": "TRF2" },
        { "count": 8, "value": "TRT1" },
        { "count": 1, "valu
e": "TRT1" }
    ],
    "phases": [
        { "count": 11, "value": "INICIAL" },
        { "count": 9, "value": "ARQUIVADO" }
    ],
    "lawsuits_count": 27
}

​
Próximos passos