Consulta Histórica por Documento (CPF/CNPJ/OAB/Nome)

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.

Resposta em cache (cached_response)Quando você cria uma consulta processual ou histórica, a Judit primeiro verifica se o dado já está em nossa base. Se estiver, devolvemos imediatamente o resultado — tanto na resposta da API quanto via webhook (se você tiver cadastrado) — com o campo cached_response: true.Em paralelo, a Judit dispara uma atualização nos tribunais. Se houver alguma mudança, você recebe uma segunda resposta com cached_response: false. Esse é o resultado mais atual.Por isso, é normal receber dois webhooks aparentemente iguais para o mesmo request_id:

O primeiro vem do cache (cached_response: true)
O último é o atualizado (cached_response: false)

Use esse campo para identificar com precisão qual retorno representa o estado mais recente do processo.

A Consulta Histórica por Documento retorna toda a carteira processual vinculada a um CPF, CNPJ, OAB ou Nome. É o caminho ideal para due diligence, KYC, mapeamento de exposição judicial e qualquer cenário em que você precise saber quais processos existem (capa + partes), sem necessariamente entrar em cada um.

Esta página documenta exclusivamente o fluxo Assíncrono de consulta histórica. O cliente deve fazer um POST /requests, aguardar o processamento (GET /requests/{id}) e resgatar os dados no GET /responses. A resposta da Consulta Histórica retorna um array paginado contendo exclusivamente a Capa e as Partes do processo (omitindo andamentos, anexos, fase e status). É possível filtrar os resultados tanto no payload do POST inicial quanto nas query strings do GET final.

Quando usar

Due diligence / KYC

Antes de fechar contrato, descubra todo o passivo judicial da contraparte por CPF/CNPJ.

Crédito e cobrança

Combine com filtros (amount_gte, side: "Passive") para priorizar abordagens com base no valor de causa.

Vigilância de carteira

Cruze com Monitoramento por documento para detectar novos processos após a consulta inicial.

Inteligência por OAB

Consulte por OAB para listar todos os processos em que um advogado atua.

Síncrono vs. Assíncrono

Antes de integrar, é fundamental entender a diferença de arquitetura que a Judit oferece para este endpoint:

Consulta Síncrona (Datalake Hotstorage): A resposta com todos os processos é devolvida instantaneamente no corpo (body) do próprio POST. Não exige checagem de status. Ideal para fluxos sensíveis à latência da resposta como onboardings. Veja a documentação Síncrona aqui.
Consulta Assíncrona (Datalake / On-Demand): É o fluxo que abordaremos nesta página. Busca em múltiplas fontes externas ou diretamente nos tribunais (On-Demand) em tempo real. Exige um fluxo de 3 etapas (Criar -> Checar -> Consumir).

Passo 1: Criar a Requisição de Busca (POST)

Para iniciar o fluxo assíncrono, faça uma requisição POST informando o documento desejado. POST https://requests.production.judit.io/requests

Exemplos de consultas históricas

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

{
    "search": {
        "search_type": "cnpj",
        "search_key": "99.999.999/9999-99"
    }
}

{
    "search": {
        "search_type": "oab",
        "search_key": "99999RJ"
    }
}

{
    "search": {
        "search_type": "name",
        "search_key": "João Silva"
    }
}

Ao realizar consultas por nome, é possível que existam homônimos (pessoas ou empresas com o mesmo nome). Recomendamos que, sempre que possível, utilize identificadores únicos, como CPF ou CNPJ, para garantir maior precisão nos resultados.

Parâmetros Base do Payload

Parâmetro	Tipo	Obrigatório	Descrição
`search.search_type`	string	Sim	tipo de entidade que será buscada: `"cpf"`, `"cnpj"`, `"oab"` ou `"name"`.
`search.search_key`	string	Sim	O valor a ser buscado (ex: `"999.999.999-99"`, `João Silva`).
`search.on_demand`	boolean	Não	Se `true`, força a busca em tempo real nos tribunais em vez do Datalake.
`cache_ttl_in_days`	integer	Não	Considera o cache válido se a última extração ocorreu nos últimos X dias.
`customer_key`	string	Não	Chave do usuário no Cofre de Credenciais (usado para acessar os tribunais com credenciais cadastrada no cofre de credenciais).

Sobre o uso da customer_key: Esta credencial só terá efeito se o parâmetro on_demand for igual a true. Ao informá-la, a Judit acessará os tribunais de forma autenticada, permitindo a captura de processos em segredo de justiça aos quais o dono da credencial (advogado) esteja previamente vinculado ao respectivo processo.

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

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

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "on_demand": true,
        "customer_key: "ADV01"
    }
}

Filtros Prévios da Requisição (`search_params.filter`)

Você pode restringir a busca inicial enviando o objeto filter dentro de search_params no corpo (body) do seu POST. Isso é altamente recomendado, pois evita que o robô perca tempo processando varas ou tribunais de estados ou anos que não importam para o seu negócio. Abaixo, detalhamos como construir cada filtro passo a passo.

1. Filtros de Polo e Valor da Causa

Permite buscar processos onde a pessoa processou alguém, foi processada, ou filtrar por valores em reais.

side (string): De qual lado do processo o documento buscado está?
- "Active" (Autor da ação)
- "Passive" (Réu na ação)
- "Interested" (Terceiro interessado)
- "Unknown" (Polo não identificado)
amount_gte (number): Valor da causa Maior ou Igual a (GTE = Greater Than or Equal).
amount_lte (number): Valor da causa Menor ou Igual a (LTE = Less Than or Equal).

// Quero achar processos onde o cliente é o Réu ("Passive") 
// E o valor da causa é entre R$ 10.000 e R$ 50.000
{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "search_params": {
            "filter": {
                "side": "Passive",
                "amount_gte": 10000.00,
                "amount_lte": 50000.00
            }
        }
    }
}

2. Filtros de Tribunal (A Regra de Inclusão e Exclusão)

Para filtrar por estados ou tribunais específicos, usamos o objeto tribunals. Ele exige duas informações: a lista de siglas (keys) e uma regra de negação (not_equal).

Lista de Tribunais Aceitos (Filtros)

Utilize as siglas exatas da coluna Sigla (Key) abaixo quando for realizar filtros por tribunais (ex: no parâmetro tribunals.keys).

Tribunais Superiores e Conselhos

Sigla (Key)	Nome Oficial do Órgão
`STF`	SUPREMO TRIBUNAL FEDERAL
`STJ`	SUPERIOR TRIBUNAL DE JUSTIÇA
`TST`	TRIBUNAL SUPERIOR DO TRABALHO
`TSE`	TRIBUNAL SUPERIOR ELEITORAL
`STM`	SUPERIOR TRIBUNAL MILITAR
`CNJ`	CONSELHO NACIONAL DE JUSTIÇA
`CJF`	CONSELHO DA JUSTIÇA FEDERAL
`CSJT`	CONSELHO SUPERIOR DA JUSTIÇA DO TRABALHO

Justiça Federal (TRF)

Sigla (Key)	Nome Oficial do Órgão
`TRF1`	TRIBUNAL REGIONAL FEDERAL DA 1ª REGIÃO
`TRF2`	TRIBUNAL REGIONAL FEDERAL DA 2ª REGIÃO
`TRF3`	TRIBUNAL REGIONAL FEDERAL DA 3ª REGIÃO
`TRF4`	TRIBUNAL REGIONAL FEDERAL DA 4ª REGIÃO
`TRF5`	TRIBUNAL REGIONAL FEDERAL DA 5ª REGIÃO

Justiça do Trabalho (TRT)

Sigla (Key)	Nome Oficial do Órgão
`TRT1`	TRT DA 1ª REGIÃO (RJ)
`TRT2`	TRT DA 2ª REGIÃO (SP - Capital)
`TRT3`	TRT DA 3ª REGIÃO (MG)
`TRT4`	TRT DA 4ª REGIÃO (RS)
`TRT5`	TRT DA 5ª REGIÃO (BA)
`TRT6`	TRT DA 6ª REGIÃO (PE)
`TRT7`	TRT DA 7ª REGIÃO (CE)
`TRT8`	TRT DA 8ª REGIÃO (PA/AP)
`TRT9`	TRT DA 9ª REGIÃO (PR)
`TRT10`	TRT DA 10ª REGIÃO (DF/TO)
`TRT11`	TRT DA 11ª REGIÃO (AM/RR)
`TRT12`	TRT DA 12ª REGIÃO (SC)
`TRT13`	TRT DA 13ª REGIÃO (PB)
`TRT14`	TRT DA 14ª REGIÃO (RO/AC)
`TRT15`	TRT DA 15ª REGIÃO (SP - Campinas)
`TRT16`	TRT DA 16ª REGIÃO (MA)
`TRT17`	TRT DA 17ª REGIÃO (ES)
`TRT18`	TRT DA 18ª REGIÃO (GO)
`TRT19`	TRT DA 19ª REGIÃO (AL)
`TRT20`	TRT DA 20ª REGIÃO (SE)
`TRT21`	TRT DA 21ª REGIÃO (RN)
`TRT22`	TRT DA 22ª REGIÃO (PI)
`TRT23`	TRT DA 23ª REGIÃO (MT)
`TRT24`	TRT DA 24ª REGIÃO (MS)

Justiça Estadual (TJ)

Sigla (Key)	Nome Oficial do Órgão
`TJAC`	TRIBUNAL DE JUSTIÇA DO ACRE
`TJAL`	TRIBUNAL DE JUSTIÇA DO ALAGOAS
`TJAP`	TRIBUNAL DE JUSTIÇA DO AMAPÁ
`TJAM`	TRIBUNAL DE JUSTIÇA DO AMAZONAS
`TJBA`	TRIBUNAL DE JUSTIÇA DA BAHIA
`TJCE`	TRIBUNAL DE JUSTIÇA DO CEARÁ
`TJDF`	TRIBUNAL DE JUSTIÇA DO DISTRITO FEDERAL E TERRITÓRIOS
`TJES`	TRIBUNAL DE JUSTIÇA DO ESPÍRITO SANTO
`TJGO`	TRIBUNAL DE JUSTIÇA DE GOIÁS
`TJMA`	TRIBUNAL DE JUSTIÇA DO MARANHÃO
`TJMT`	TRIBUNAL DE JUSTIÇA DO MATO GROSSO
`TJMS`	TRIBUNAL DE JUSTIÇA DO MATO GROSSO DO SUL
`TJMG`	TRIBUNAL DE JUSTIÇA DE MINAS GERAIS
`TJPA`	TRIBUNAL DE JUSTIÇA DO PARÁ
`TJPB`	TRIBUNAL DE JUSTIÇA DA PARAÍBA
`TJPR`	TRIBUNAL DE JUSTIÇA DO PARANÁ
`TJPE`	TRIBUNAL DE JUSTIÇA DE PERNAMBUCO
`TJPI`	TRIBUNAL DE JUSTIÇA DO PIAUÍ
`TJRJ`	TRIBUNAL DE JUSTIÇA DO RIO DE JANEIRO
`TJSP`	TRIBUNAL DE JUSTIÇA DE SÃO PAULO
`TJRN`	TRIBUNAL DE JUSTIÇA DO RIO GRANDE DO NORTE
`TJRS`	TRIBUNAL DE JUSTIÇA DO RIO GRANDE DO SUL
`TJRO`	TRIBUNAL DE JUSTIÇA DE RONDÔNIA
`TJRR`	TRIBUNAL DE JUSTIÇA DE RORAIMA
`TJSC`	TRIBUNAL DE JUSTIÇA DE SANTA CATARINA
`TJSE`	TRIBUNAL DE JUSTIÇA DE SERGIPE

Justiça Eleitoral (TRE)

Sigla (Key)	Nome Oficial do Órgão
`TRE-AC`	TRIBUNAL REGIONAL ELEITORAL DO ACRE
`TRE-AL`	TRIBUNAL REGIONAL ELEITORAL DO ALAGOAS
`TRE-AP`	TRIBUNAL REGIONAL ELEITORAL DO AMAPÁ
`TRE-AM`	TRIBUNAL REGIONAL ELEITORAL DO AMAZONAS
`TRE-BA`	TRIBUNAL REGIONAL ELEITORAL DA BAHIA
`TRE-CE`	TRIBUNAL REGIONAL ELEITORAL DO CEARÁ
`TRE-DF`	TRIBUNAL REGIONAL ELEITORAL DO DISTRITO FEDERAL
`TRE-ES`	TRIBUNAL REGIONAL ELEITORAL DO ESPÍRITO SANTO
`TRE-GO`	TRIBUNAL REGIONAL ELEITORAL DE GOIÁS
`TRE-MA`	TRIBUNAL REGIONAL ELEITORAL DO MARANHÃO
`TRE-MT`	TRIBUNAL REGIONAL ELEITORAL DO MATO GROSSO
`TRE-MS`	TRIBUNAL REGIONAL ELEITORAL DO MATO GROSSO DO SUL
`TRE-MG`	TRIBUNAL REGIONAL ELEITORAL DE MINAS GERAIS
`TRE-PA`	TRIBUNAL REGIONAL ELEITORAL DO PARÁ
`TRE-PB`	TRIBUNAL REGIONAL ELEITORAL DA PARAÍBA
`TRE-PR`	TRIBUNAL REGIONAL ELEITORAL DO PARANÁ
`TRE-PE`	TRIBUNAL REGIONAL ELEITORAL DE PERNAMBUCO
`TRE-PI`	TRIBUNAL REGIONAL ELEITORAL DO PIAUÍ
`TRE-RJ`	TRIBUNAL REGIONAL ELEITORAL DO RIO DE JANEIRO
`TRE-RN`	TRIBUNAL REGIONAL ELEITORAL DO RIO GRANDE DO NORTE
`TRE-RS`	TRIBUNAL REGIONAL ELEITORAL DO RIO GRANDE DO SUL
`TRE-RO`	TRIBUNAL REGIONAL ELEITORAL DE RONDÔNIA
`TRE-RR`	TRIBUNAL REGIONAL ELEITORAL DE RORAIMA
`TRE-SC`	TRIBUNAL REGIONAL ELEITORAL DE SANTA CATARINA
`TRE-SE`	TRIBUNAL REGIONAL ELEITORAL DE SERGIPE
`TRE-SP`	TRIBUNAL REGIONAL ELEITORAL DE SÃO PAULO
`TRE-TO`	TRIBUNAL REGIONAL ELEITORAL DO TOCANTINS

Justiça Militar (União e Estadual)

Sigla (Key)	Nome Oficial do Órgão
`CJM1`	PRIMEIRA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM2`	SEGUNDA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM3`	TERCEIRA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM4`	QUARTA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM5`	QUINTA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM6`	SEXTA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM7`	SÉTIMA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM8`	OITAVA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM9`	NONA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM10`	DÉCIMA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM11`	DÉCIMA PRIMEIRA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`CJM12`	DÉCIMA SEGUNDA CIRCUNSCRIÇÃO JUDICIÁRIA MILITAR
`TJM-MG`	TRIBUNAL DE JUSTIÇA MILITAR DO ESTADO DE MINAS GERAIS
`TJM-RS`	TRIBUNAL DE JUSTIÇA MILITAR DO ESTADO DO RIO GRANDE DO SUL
`TJM-SP`	TRIBUNAL DE JUSTIÇA MILITAR DO ESTADO DE SÃO PAULO

Inclusão: Se not_equal for false, a API vai buscar APENAS nos tribunais da lista.
Exclusão: Se not_equal for true, a API vai buscar no Brasil inteiro, EXCETO nos tribunais da lista.

Exemplo JSON: Inclusão vs. Exclusão de Tribunais

// Traz apenas processos de São Paulo e Bahia
{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "search_params": {
            "filter": {
                "tribunals": {
                    "keys": [
                        "TJSP",
                        "TJBA"
                    ],
                    "not_equal": false
                }
            }
        }
    }
}

// Traz do Brasil inteiro, mas ignora a Justiça Federal (TRFs)
{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "search_params": {
            "filter": {
                "tribunals": {
                    "keys": [
                        "TRF1",
                        "TRF2",
                        "TRF3",
                        "TRF4",
                        "TRF5",
                        "TRF6"
                    ],
                    "not_equal": true
                }
            }
        }
    }
}

3. Filtros de Assunto e Classe (Padrão CNJ)

A Judit API utiliza as Tabelas Processuais Unificadas (TPU) oficiais do Conselho Nacional de Justiça (CNJ). Você pode filtrar processos inserindo os códigos numéricos exatos dessas tabelas. 👉 Para descobrir os códigos oficiais de Classes e Assuntos, acesse a Consulta Pública do SGT/CNJ. A mecânica de filtro funciona da seguinte forma:

Assuntos (subject_codes): Usa as listas contains (Quero processos que contenham estes códigos) e not_contains (Não quero processos que contenham estes códigos).
Classes (classification_codes): Usa a lista keys e a regra not_equal (a mesma lógica de inclusão/exclusão dos tribunais).

Exemplo JSON: Filtrando por Assuntos e Classes

{
    "search": {
        "search_type": "cpf",
        "search_key": "99999999999",
        "search_params": {
            "filter": {
                // Quero processos que tenham o assunto 10433, mas rejeito se tiver o 1120
                "subject_codes": {
                    "contains": [
                        "10433"
                    ],
                    "not_contains": [
                        "1120"
                    ]
                },
                // Quero EXATAMENTE a classe processual 985 (ex: Ação Trabalhista)
                "classification_codes": {
                    "keys": [
                        "985"
                    ],
                    "not_equal": false
                }
            }
        }
    }
}

4. Filtros de Datas e Prazos

Otimize a busca por recortes de tempo usando o formato universal de datas (ISO 8601: AAAA-MM-DDTHH:mm:ss.sssZ).

distribution_date_gte (string): Traz processos distribuídos (iniciados) a partir de uma data.
last_step_date_gte (string): Traz processos cuja última movimentação ocorreu a partir de uma data.
last_step_date_lte (string): Traz processos cuja última movimentação ocorreu antes de uma data.

Exemplo JSON: Filtrando por Datas

{
    "search": {
        "search_type": "cpf",
        "search_key": "99999999999",
        "search_params": {
            // Quero processos que tiveram alguma movimentação a partir de 10 de Outubro de 2024
            "filter": {
                "last_step_date_gte": "2024-10-10T00:00:00.000Z"
            }
        }
    }
}

5. Filtros Restritivos de Outras Partes

Quer saber se o João processou a Empresa X? Você pode usar os filtros de Nomes e Documentos de outras partes envolvidas no processo.

party_names (array de strings): Lista de nomes exatos que devem constar no processo.
party_documents (array de strings): Lista de CPFs/CNPJs que devem constar no processo.

Atenção ao usar junto com o filtro side: Se você usar o filtro party_names ou party_documents junto com o filtro side, a regra de “Polo” (Autor/Réu) será aplicada apenas ao documento principal que você está pesquisando, e não aos nomes/documentos extras listados aqui.

Exemplo JSON: Partes Específicas

{
    "search": {
        "search_type": "cpf",
        "search_key": "99999999999",
        "search_params": {
            // Buscando o CPF principal (via search_key), mas exigindo que
            // a "Empresa Exemplo" ou o CNPJ "99.999.999/0001-99" também estejam no processo.
            "filter": {
                "party_names": [
                    "EMPRESA EXEMPLO LTDA"
                ],
                "party_documents": [
                    "99999999000199"
                ]
            }
        }
    }
}

Exemplo de Requisição (POST)

curl --location 'https://requests.production.judit.io/requests/' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "on_demand": true,
        "search_params": {
            "filter": {
                "side": "Passive",
                "tribunals": {
                    "keys": ["TJBA"],
                    "not_equal": false
                }
            }
        }
    }
}'

Guarde o request_id (ex: 05ee9825...) gerado na resposta desta chamada. Ele é o seu passaporte para os próximos passos.

🚀 Atalho: Automatize com Webhooks (Recomendado)Se você possui uma URL de Webhook configurada, os Passos 2 e 3 abaixo são totalmente opcionais. Em vez de programar sua aplicação para ficar perguntando o status da requisição, a Judit API enviará os processos encontrados de forma incremental diretamente para o seu servidor assim que eles forem capturados, finalizando o fluxo com um evento de request_completed.👉 Aprenda a configurar e receber Webhooks aqui

Passo 2: Consultar o Status da Requisição

Como um documento pode estar atrelado a centenas de processos no Brasil, a coleta leva tempo. Você deve consultar o status macro da requisição usando o ID do Passo 1. GET https://requests.production.judit.io/requests/<REQUEST_ID>

cURL (Passo 2)

curl --location 'https://requests.production.judit.io/requests/<request_id>' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data ''

Você deve realizar polling (consultas periódicas) nesta rota até que a propriedade "status" mude de "pending" para "completed". (Nota: O uso de Webhooks elimina a necessidade deste passo).

Verificação Granular (Apenas para On-Demand)

Como a busca On-Demand consulta dezenas de sistemas simultaneamente, você pode acompanhar o status individual de cada tribunal acessado usando a rota de Crawls:

cURL

curl --location 'https://crawler.production.judit.io/crawls/request/<request_id>?page=1&page_size=10' \
    --header 'api-key: <api-key>'

Ver exemplo de Resposta de Status On-Demand

{
    "page": 1,
    "page_data": [
        {
            "source_name": "JPje - RO - Lawsuit - Auth - 2 instance",
            "tribunal_acronym": "TJRO",
            "status": "done",
            "updated_at": "2025-10-28T00:04:40.651Z"
        },
        {
            "source_name": "JTJRJ - RJ - Lawsuit - Auth - 1 instance",
            "tribunal_acronym": "TJRJ",
            "status": "pending",
            "updated_at": "2025-10-28T00:04:53.157Z"
        }
    ]
}

Passo 3: Consumir e Filtrar os Resultados (GET)

Assim que o status no Passo 2 retornar "completed", os dados estão prontos! É aqui, na rota GET /responses, que você puxa o JSON final. A grande sacada deste endpoint é que ele permite aplicar filtros dinâmicos via URL (Query Params), permitindo que você fatie, ordene e pagine a resposta final do jeito que quiser, sem precisar gerar uma nova requisição (POST). GET https://requests.production.judit.io/responses/

Filtros Dinâmicos na URL (Query Params)

Estes são os parâmetros que você pode concatenar na sua requisição final:

Query Param	Tipo / Formato	Descrição
`request_id`	string (UUID)	Obrigatório. O ID gerado no Passo 1.
`page`	integer	Número da página atual para navegação (Padrão: `1`).
`page_size`	integer	Quantidade de resultados retornados por página. Máximo permitido: 1000 (Recomendado: `100`).
`response_type`	array JSON	Tipo de resposta desejada. Ex: `["lawsuit"]`.
`code`	array JSON	Filtra por números de processo específicos. Ex: `["0601708-42..."]`.
`instance`	array JSON	Filtra pelos graus de jurisdição. Ex: `[1, 2]`.
`cached`	boolean	Retorna apenas processos cacheados (`true`) ou de captura nova (`false`).
`classifications_code`	array JSON	Códigos de classe processual exatos (Ex: `["437"]`).
`subjects_code`	array JSON	Códigos de assunto do CNJ exatos (Ex: `["6226"]`).
`created_at_gte` / `lte`	string (Data)	Filtra pela data em que o processo entrou na base da Judit.
`order`	objeto JSON	Ordena a listagem. Ex: `{"created_at": "desc"}`.
`tags.criminal`	boolean	Retorna `true` apenas para processos da esfera criminal.

# Retorna os processos usando apenas o parâmetro obrigatório
curl -X GET "[https://requests.production.judit.io/responses?request_id=](https://requests.production.judit.io/responses?request_id=)<SEU_REQUEST_ID>" \
  -H "api-key: SUA_API_KEY" \
  -H "Content-Type: application/json"

# O parâmetro -g (--globoff) permite o uso de colchetes [] na URL sem quebrar o terminal.
# Nota: Na sua aplicação, lembre-se de aplicar URL Encoding nesses parâmetros.

curl -g -X GET "[https://requests.production.judit.io/responses](https://requests.production.judit.io/responses)\
?request_id=<SEU_REQUEST_ID>\
&response_type=[\"lawsuit\"]\
&code=[\"0601708-42.2025.8.04.4700\"]\
&instance=[1,2]\
&cached=false\
&classifications_code=[\"437\"]\
&classifications_name=[\"PROCEDIMENTO DO JUIZADO ESPECIAL CÍVEL\"]\
&subjects_code=[\"6226\"]\
&subjects_name=\"INCLUSÃO INDEVIDA EM CADASTRO DE INADIMPLENTES\"\
&created_at_gte=2026-03-01T00:00:00.000Z\
&created_at_lte=2026-03-05T00:00:00.000Z\
&request_created_at_gte=2026-03-02T00:00:00.000Z\
&request_created_at_lte=2026-03-05T00:00:00.000Z\
&page=1\
&page_size=1000\
&order={\"created_at\":\"desc\"}\
&tags.criminal=true" \
  -H "api-key: SUA_API_KEY" \
  -H "Content-Type: application/json"

O formato da Resposta

O retorno traz as chaves de paginação e o array page_data, onde cada objeto contém a response_data (A Capa do Processo).

string

Status final da resposta (Deve ser completed).

integer

Página atual da busca.

integer

Total de processos renderizados nesta página.

integer

Total absoluto de processos encontrados e vinculados ao documento.

integer

Quantidade total de páginas disponíveis.

array

Array de objetos. Cada objeto contém a chave response_data que abriga a Capa do Processo.

Ver Exemplo da Estrutura do Processo Retornado

{
  "page": 1,
  "page_count": 1,
  "all_count": 1,
  "all_pages_count": 1,
  "request_status": "completed",
  "page_data": [
    {
      "request_id": "05ee9825-b2b4-480b-b29e-f071ca7d9c72",
      "response_id": "e49d2e2c-92ed-4dad-8701-c53a569d675b",
      "response_type": "lawsuit",
      "response_data": {
        "code": "0000000-00.0000.0.00.0000",
        "tribunal_acronym": "TJSP",
        "instance": 1,
        "parties": [
          { "name": "Usuário teste", "side": "Active", "person_type": "Autor" }
        ]
      }
    }
  ]
}

Primeiros Passos

Conceitos Fundamentais

Modelo de Dados (Schemas)

Consultas Assíncronas

Consultas Síncronas

Monitoramento

Dados Cadastrais

Consultas Penais

Transferência de Arquivos

Cofre de Credenciais

Webhook

Recursos

Quando usar

Due diligence / KYC

Crédito e cobrança

Vigilância de carteira

Inteligência por OAB

Síncrono vs. Assíncrono

Passo 1: Criar a Requisição de Busca (POST)

Exemplos de consultas históricas

Parâmetros Base do Payload

Filtros Prévios da Requisição (`search_params.filter`)

1. Filtros de Polo e Valor da Causa

2. Filtros de Tribunal (A Regra de Inclusão e Exclusão)

Lista de Tribunais Aceitos (Filtros)

3. Filtros de Assunto e Classe (Padrão CNJ)

4. Filtros de Datas e Prazos

5. Filtros Restritivos de Outras Partes

Exemplo de Requisição (POST)

Passo 2: Consultar o Status da Requisição

Verificação Granular (Apenas para On-Demand)

Passo 3: Consumir e Filtrar os Resultados (GET)

Filtros Dinâmicos na URL (Query Params)

O formato da Resposta

​Quando usar

Due diligence / KYC

Crédito e cobrança

Vigilância de carteira

Inteligência por OAB

​Síncrono vs. Assíncrono

​Passo 1: Criar a Requisição de Busca (POST)

​Exemplos de consultas históricas

​Parâmetros Base do Payload

​Filtros Prévios da Requisição (search_params.filter)

​1. Filtros de Polo e Valor da Causa

​2. Filtros de Tribunal (A Regra de Inclusão e Exclusão)

​Lista de Tribunais Aceitos (Filtros)

​3. Filtros de Assunto e Classe (Padrão CNJ)

​4. Filtros de Datas e Prazos

​5. Filtros Restritivos de Outras Partes

​Exemplo de Requisição (POST)

​Passo 2: Consultar o Status da Requisição

​Verificação Granular (Apenas para On-Demand)

​Passo 3: Consumir e Filtrar os Resultados (GET)

​Filtros Dinâmicos na URL (Query Params)

​O formato da Resposta

Quando usar

Síncrono vs. Assíncrono

Passo 1: Criar a Requisição de Busca (POST)

Exemplos de consultas históricas

Parâmetros Base do Payload

Filtros Prévios da Requisição (`search_params.filter`)

1. Filtros de Polo e Valor da Causa

2. Filtros de Tribunal (A Regra de Inclusão e Exclusão)

Lista de Tribunais Aceitos (Filtros)

3. Filtros de Assunto e Classe (Padrão CNJ)

4. Filtros de Datas e Prazos

5. Filtros Restritivos de Outras Partes

Exemplo de Requisição (POST)

Passo 2: Consultar o Status da Requisição

Verificação Granular (Apenas para On-Demand)

Passo 3: Consumir e Filtrar os Resultados (GET)

Filtros Dinâmicos na URL (Query Params)

O formato da Resposta