> ## 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 Customizada por Filtros

> Crie buscas avançadas combinando múltiplos filtros (tribunal, valor da causa, data de distribuição, partes, classes processuais) na 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>;

A **Consulta Customizada** permite varrer todos os tribunais cobertos pela Judit aplicando filtros estruturais — sem precisar partir de um CPF, CNPJ, OAB ou Nome específico. É a ferramenta certa quando o universo de busca é definido por critérios objetivos (ex.: "todos os processos trabalhistas no TRT-2 distribuídos em 2024 com valor de causa acima de R\$ 100 mil").

<Warning>
  A Consulta Customizada é entregue via **relatório sob demanda** (não em fluxo automático). Acione nosso time [comercial](https://api.whatsapp.com/send/?phone=5521985284143) para habilitar o serviço e receber o resultado por arquivo (CSV/JSON) ou via [File Transfer API](/file-transfer/file-transfer).
</Warning>

## Quando usar

<CardGroup cols={2}>
  <Card title="Mapeamento de mercado" icon="binoculars">
    Identifique o universo de processos de uma classe específica em um tribunal ou estado para análise de tendências.
  </Card>

  <Card title="Due diligence em massa" icon="magnifying-glass-chart">
    Valide o passivo judicial de uma carteira inteira de empresas/pessoas combinando filtros de valor, tribunal e classe.
  </Card>

  <Card title="Inteligência competitiva" icon="briefcase">
    Mapeie processos em que escritórios concorrentes atuam para análise estratégica.
  </Card>

  <Card title="Monitoramento por tema" icon="bullseye">
    Detecte processos em assuntos específicos (ex.: ANS, ANATEL, Defesa do Consumidor) ao longo do tempo.
  </Card>
</CardGroup>

## Filtros disponíveis

| Filtro                                            | Tipo     | Descrição                                                                                    |
| ------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------- |
| `side`                                            | string   | Lado da parte: `Active` (Autor), `Passive` (Réu), `Interested` (Interessado), ou indefinido. |
| `amount_gte` / `amount_lte`                       | number   | Valor da causa **mínimo** / **máximo**.                                                      |
| `distribution_date_gte` / `distribution_date_lte` | ISO 8601 | Janela de distribuição do processo.                                                          |
| `last_step_date_gte` / `last_step_date_lte`       | ISO 8601 | Janela da última movimentação.                                                               |
| `tribunals.keys` + \`                             |          |                                                                                              |