> ## 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. # Consulta Síncrona Agrupada (Synthetic) > Receba contagens agregadas (por tribunal, classe, área, status, fase, instância e parte) de todos os processos vinculados a um documento na Judit API — leitura síncrona ideal para dashboards e análises. export const EndpointBadges = ({auth = true, billing = "billable", flow = "sync", attachments = false, requiresVault = false}) =>
{auth && 🔒 Requer api-key} {billing === "billable" && 💰 Cobrança por requisição} {billing === "free" && ✅ Grátis} {billing === "on-demand" && ⚡ On-demand (preço diferenciado)} {flow === "async" && ⏳ Assíncrono · webhook ou polling} {flow === "sync" && ⚡ Síncrono} {attachments && 📎 Suporta with_attachments} {requiresVault && 🔑 Cofre de Credenciais}
; **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](https://normasinternet2.receita.fazenda.gov.br/#/consulta/externa/141102). * **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](/cache-judit/hotstorage)). Para apenas saber se existem processos (true/false) ou contar, use [`POST /lawsuits/count`](/api-reference/endpoint/crawler/req-count). ## Quando usar Painéis de exposição judicial: contagens por tribunal, fase, instância, área — sem precisar listar cada processo. Em onboarding ou crédito: descubra em ms o perfil judicial de uma contraparte (cível vs. trabalhista vs. tributário). Antes de decidir entre consulta detalhada ou amostral, veja o tamanho e a distribuição do conjunto. 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 ```json Por CPF theme={null} { "search": { "search_type": "cpf", "search_key": "999.999.999-99" } } ``` ```json Por CNPJ theme={null} { "search": { "search_type": "cnpj", "search_key": "99.999.999/9999-99" } } ``` ```json Por OAB theme={null} { "search": { "search_type": "oab", "search_key": "99999RJ" } } ``` ```json Por Nome theme={null} { "search": { "search_type": "name", "search_key": "João Silva" } } ``` ### Parâmetros do Payload | Parâmetro | Tipo | Obrigatório | Descrição | | :---------------------------- | :----- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | | `search.search_type` | string | **Sim** | `"cpf"`, `"cnpj"`, `"oab"` ou `"name"`. | | `search.search_key` | string | **Sim** | Valor a ser buscado. | | `search.search_params.filter` | object | Não | Filtros estruturais — mesma estrutura da [consulta histórica](/requests/request-document#filtros-prévios-da-requisição-search_params-filter). | ### Exemplos com filtros ```json Filtro por polo passivo + valor theme={null} { "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 } } } } ``` ```json Filtro por janela de distribuição theme={null} { "search": { "search_type": "cpf", "search_key": "999.999.999-99", "search_params": { "filter": { "distribution_date_gte": "2024-01-01T00:00:00.000Z" } } } } ``` ```json Excluir tribunais específicos theme={null} { "search": { "search_type": "cnpj", "search_key": "00.000.000/0001-00", "search_params": { "filter": { "tribunals": { "keys": ["TJSP"], "not_equal": true } } } } } ``` ### Exemplo de Requisição (POST) ```bash cURL theme={null} 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" } }' ``` ```python Python theme={null} import os, requests resp = requests.post( "https://lawsuits.production.judit.io/lawsuits/synthetic", headers={ "api-key": os.environ["JUDIT_API_KEY"], "Content-Type": "application/json", }, json={"search": {"search_type": "cpf", "search_key": "999.999.999-99"}}, timeout=15, ) resp.raise_for_status() print(resp.json()) ``` ```javascript Node.js theme={null} const res = await fetch( "https://lawsuits.production.judit.io/lawsuits/synthetic", { method: "POST", headers: { "api-key": process.env.JUDIT_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ search: { search_type: "cpf", search_key: "999.999.999-99" }, }), } ); console.log(await res.json()); ``` ```go Go theme={null} package main import ( "bytes" "encoding/json" "io" "net/http" "os" ) func main() { body, _ := json.Marshal(map[string]any{ "search": map[string]string{ "search_type": "cpf", "search_key": "999.999.999-99", }, }) req, _ := http.NewRequest("POST", "https://lawsuits.production.judit.io/lawsuits/synthetic", bytes.NewReader(body)) req.Header.Set("api-key", os.Getenv("JUDIT_API_KEY")) req.Header.Set("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() out, _ := io.ReadAll(res.Body) println(string(out)) } ``` ## 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 }`. | Eixo | O que agrupa | | :---------------- | :--------------------------------------------------- | | `classifications` | Classes processuais (ex.: PROCEDIMENTO COMUM CÍVEL). | | `subjects` | Assuntos processuais (ex.: ACIDENTE DE TRÂNSITO). | | `areas` | Áreas do direito (ex.: DIREITO CIVIL). | | `tribunals` | Siglas dos tribunais (ex.: TJSP, TRT1). | | `justices` | Justiça (Estadual, Federal, etc.). | | `phases` | Fase processual atual. | | `states` | UF onde tramita. | | `instances` | Instância (1 ou 2). | | `sides` | Polo da parte buscada (PASSIVE, ACTIVE, INTERESTED). | | `person_types` | Tipo da parte (REQUERENTE, AUTOR, RÉU, etc.). | | `lawsuits_count` | Total geral de processos do universo. | ### Exemplo de resposta ```json theme={null} { "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 * Para listar processos individualmente: [Hot Storage](/cache-judit/hotstorage). * Para contagem global: [`POST /lawsuits/count`](/api-reference/endpoint/crawler/req-count). * Para varrer múltiplos critérios: [Consulta Customizada](/requests/custom-search).