> ## 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.

# Custom Search by Filters

> Build advanced searches combining multiple filters (court, claim amount, distribution date, parties, lawsuit class) on the Judit API.

export const EndpointBadges = ({auth = true, billing = "billable", flow = "sync", attachments = false, requiresVault = false}) => <div style={{
  marginTop: "-8px",
  marginBottom: "16px"
}}>
    {auth && <Badge color="gray">🔒 Requer api-key</Badge>}
    {billing === "billable" && <Badge color="yellow">💰 Cobrança por requisição</Badge>}
    {billing === "free" && <Badge color="green">✅ Grátis</Badge>}
    {billing === "on-demand" && <Badge color="purple">⚡ On-demand (preço diferenciado)</Badge>}
    {flow === "async" && <Badge color="blue">⏳ Assíncrono · webhook ou polling</Badge>}
    {flow === "sync" && <Badge color="green">⚡ Síncrono</Badge>}
    {attachments && <Badge color="purple">📎 Suporta with_attachments</Badge>}
    {requiresVault && <Badge color="red">🔑 Cofre de Credenciais</Badge>}
  </div>;

The **Custom Search** lets you scan every court covered by Judit applying structural filters — without needing a specific CPF, CNPJ, OAB or Name as a starting point. It is the right tool when the search universe is defined by objective criteria (e.g.: "all labor lawsuits in TRT-2 distributed in 2024 with claim amount above BRL 100k").

## When to use

<CardGroup cols={2}>
  <Card title="Market mapping" icon="binoculars">
    Identify the universe of lawsuits in a specific class, court or state to drive trend analysis.
  </Card>

  <Card title="Mass due diligence" icon="magnifying-glass-chart">
    Validate the judicial liabilities of an entire portfolio combining filters by amount, court and class.
  </Card>

  <Card title="Competitive intelligence" icon="briefcase">
    Map lawsuits where competitor firms participate for strategic analysis.
  </Card>

  <Card title="Topic monitoring" icon="bullseye">
    Detect lawsuits in specific subjects (e.g. consumer protection, regulatory) over time.
  </Card>
</CardGroup>

## Available filters

| Filter                                            | Type     | Description                                                                          |
| ------------------------------------------------- | -------- | ------------------------------------------------------------------------------------ |
| `side`                                            | string   | Party side: `Active` (plaintiff), `Passive` (defendant), `Interested`, or undefined. |
| `amount_gte` / `amount_lte`                       | number   | **Minimum** / **maximum** claim amount.                                              |
| `distribution_date_gte` / `distribution_date_lte` | ISO 8601 | Distribution-date window.                                                            |
| `last_step_date_gte` / `last_step_date_lte`       | ISO 8601 | Last-step date window.                                                               |
| `tribunals.keys` + `not_equal`                    | array    |                                                                                      |