Synchronous Grouped Query (Synthetic)

New CNPJ format (IN 2229/24)Judit already accepts the new alphanumeric CNPJ format in compliance with the Brazilian Federal Revenue Normative Instruction No. 2229/2024.

Zero effort: no changes are required in your integration.
Test environment: use the document A1B2C3D4/E5F6-68 to validate the flow and receive a mock lawsuit in response.

The Grouped (Synthetic) Query delivers, in a single synchronous call, a statistical summary of every lawsuit linked to a document, grouped by class, subject, area, court, justice, phase, state, instance, party side and person type. Use it when the client needs a bird’s-eye view rather than the full list.

🤖 Endpoint: POST https://lawsuits.production.judit.io/lawsuits/synthetic. Synchronous response with aggregated counts. To list each lawsuit, use POST /lawsuits (Hot Storage). For a simple existence/count, use POST /lawsuits/count.

When to use

Executive dashboards

Judicial-exposure panels: counts per court, phase, instance, area — without listing every lawsuit.

Quick risk analysis

Onboarding or credit decisions: discover in milliseconds the judicial profile of a counterpart (civil vs. labor vs. tax).

Pre-segmentation

Before deciding between full or sample queries, see the size and distribution of the set.

Periodic reports

Weekly/monthly reports aggregated by portfolio without trafficking large lawsuit volumes.

Step 1: Create the Grouped Query (POST)

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

Examples by document type

{
    "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": "John Smith"
    }
}

Payload parameters

Parameter	Type	Required	Description
`search.search_type`	string	Yes	`"cpf"`, `"cnpj"`, `"oab"` or `"name"`.
`search.search_key`	string	Yes	Value to search.
`search.search_params.filter`	object	No	Structural filters — same shape as the historical query.

Examples with filters

{
    "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
            }
        }
    }
}

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "search_params": {
            "filter": {
                "distribution_date_gte": "2024-01-01T00:00:00.000Z"
            }
        }
    }
}

{
    "search": {
        "search_type": "cnpj",
        "search_key": "00.000.000/0001-00",
        "search_params": {
            "filter": {
                "tribunals": { "keys": ["TJSP"], "not_equal": true }
            }
        }
    }
}

Request example (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"
    }
  }'

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())

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());

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))
}

Step 2: Read the response

The response is synchronous (HTTP 200) and aggregates the universe across multiple axes. lawsuits_count is the overall total; each axis is an array of { count, value }.

Axis	What it groups
`classifications`	Lawsuit classes (e.g. PROCEDIMENTO COMUM CÍVEL).
`subjects`	Lawsuit subjects (e.g. ACIDENTE DE TRÂNSITO).
`areas`	Areas of law (e.g. DIREITO CIVIL).
`tribunals`	Court acronyms (e.g. TJSP, TRT1).
`justices`	Branch (State, Federal, etc.).
`phases`	Current procedural phase.
`states`	State (UF) where the lawsuit runs.
`instances`	Instance (1 or 2).
`sides`	Side of the searched party (PASSIVE, ACTIVE, INTERESTED).
`person_types`	Party type (REQUERENTE, AUTOR, RÉU, etc.).
`lawsuits_count`	Overall total of lawsuits

Getting Started

Core Concepts

Data Models (Schemas)

Asynchronous Requests

Synchronous Requests

Tracking

Registration Data

Criminal Records

File Transfer

Credentials Vault

Webhook

Resources

When to use

Executive dashboards

Quick risk analysis

Pre-segmentation

Periodic reports

Step 1: Create the Grouped Query (POST)

Examples by document type

Payload parameters

Examples with filters

Request example (POST)

Step 2: Read the response

​When to use

Executive dashboards

Quick risk analysis

Pre-segmentation

Periodic reports

​Step 1: Create the Grouped Query (POST)

​Examples by document type

​Payload parameters

​Examples with filters

​Request example (POST)

​Step 2: Read the response

When to use

Step 1: Create the Grouped Query (POST)

Examples by document type

Payload parameters

Examples with filters

Request example (POST)

Step 2: Read the response