# Processos Judiciais - Resumo Agrupado

> Consulta processos judiciais agrupados por segmento, tribunal, área de direito e ano, com estatísticas consolidadas. Usado em análises de risco, crédito e integridade jurídica.

- **Consulta:** `processos-agrupada`
- **Categoria:** Processos Judiciais
- **Preço:** R$ 1,65 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/processos-agrupada`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/processos-judiciais/processos-agrupada

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Fornece uma visão consolidada de processos judiciais associados a uma pessoa jurídica, apresentando dados estruturados por segmentos de justiça, tribunais, períodos e áreas do direito. O endpoint agrupa e sintetiza informações sobre litígios, facilitando análises estratégicas e avaliações de risco.
>
> **Ideal para:**
> - Mapeamento de histórico processual em análises de crédito e integridade
> - Avaliação de exposição legal durante processos de due diligence e compliance
> - Verificações de risco em onboarding de clientes, fornecedores e parceiros
> - Identificação de padrões jurídicos e distribuição de processos ao longo do tempo
> - Suporte a prevenção a fraudes e conformidade regulatória
>
> **Benefícios:**
> - Acesso rápido e estruturado a dados judiciais consolidados
> - Eliminação de consultas manuais fragmentadas
> - Redução de tempo em análises jurídicas e financeiras
> - Organização clara por segmento, tribunal, área de direito e série histórica

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/processos-agrupada?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/processos-agrupada",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/processos-agrupada");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | condicional | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta retorna um objeto com os seguintes campos:
>
> - **`documentoConsultado`**: Documento utilizado na consulta.
>
> - **`segmentos`**: Arranjo contendo segmentos de justiça (cível, trabalhista, criminal, etc.) com totalizações por tipo.
>
> - **`tribunais`**: Arranjo com tribunais relacionados aos processos e respectivas contagens.
>
> - **`distribuicaoPorAno`**: Série histórica de processos agrupada por ano, permitindo visualizar evolução temporal.
>
> - **`areasDireito`**: Arranjo detalhando cada área jurídica (direito civil, administrativo, previdenciário, etc.) com:
>   - Tipo de área
>   - Quantidade de processos
>   - Valor total envolvido (quando disponível)
>
> - **`totalProcessos`**: Contagem consolidada de todos os processos encontrados.
>
> - **`observacoes`**: Informações complementares e ressalvas aplicáveis ao resultado da consulta.

### Exemplo de resposta

```json
{
  "segmentos": [
    {
      "segmento": "string",
      "totalPorSegmento": "number"
    }
  ],
  "tribunais": [
    {
      "tribunal": "string",
      "totalPorTribunal": "number"
    }
  ],
  "observacoes": "string",
  "areasDireito": [
    {
      "areaDireito": "string",
      "tipoAreaDireito": "string",
      "totalProcessosArea": "number",
      "totalValorProcessosArea": "string"
    }
  ],
  "totalProcessos": "number",
  "resumoProcessos": {
    "comoReu": "number",
    "comoAutor": "number",
    "poloIndeterminado": "number",
    "valorTotalComoReu": "number"
  },
  "distribuicaoPorAno": [
    {
      "ano": "string",
      "totalPorAno": "number"
    }
  ],
  "documentoConsultado": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "segmentos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "segmento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do segmento de justiça."
          },
          "totalPorSegmento": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total de processos para este segmento."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de segmentos de justiça com totais."
    },
    "tribunais": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "tribunal": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identificação do tribunal."
          },
          "totalPorTribunal": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total de processos neste tribunal."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de tribunais com totais."
    },
    "observacoes": {
      "type": [
        "string",
        "null"
      ],
      "description": "Observações e informações complementares sobre a consulta."
    },
    "areasDireito": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "areaDireito": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da área de direito."
          },
          "tipoAreaDireito": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de classificação da área de direito."
          },
          "totalProcessosArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total de processos nesta área de direito."
          },
          "totalValorProcessosArea": {
            "type": [
              "string",
              "null"
            ],
            "description": "Valor total dos processos nesta área de direito."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de áreas de direito com estatísticas."
    },
    "totalProcessos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade total de processos encontrados."
    },
    "resumoProcessos": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "comoReu": {
          "type": "integer",
          "description": "Processos em que o consultado é réu (polo passivo)."
        },
        "comoAutor": {
          "type": "integer",
          "description": "Processos em que o consultado é autor (polo ativo)."
        },
        "poloIndeterminado": {
          "type": "integer",
          "description": "Processos em que não foi possível identificar o polo do consultado."
        },
        "valorTotalComoReu": {
          "type": "number",
          "description": "Soma do valor das ações em que o consultado é réu."
        }
      },
      "description": "Resumo dos processos pelo polo do documento consultado."
    },
    "distribuicaoPorAno": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "ano": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ano de competência do processo."
          },
          "totalPorAno": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total de processos neste ano."
          }
        }
      },
      "x-display": "table",
      "description": "Distribuição de processos por ano."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento (CPF ou CNPJ) que foi consultado."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Cada requisição deve incluir um único documento
> - A consulta retorna informações consolidadas; detalhes específicos de processos individuais não são fornecidos neste endpoint
> - Dados são atualizados periodicamente conforme disponibilidade de fontes
> - Em caso de indisponibilidade temporária do serviço, uma mensagem informativa será retornada na resposta

---

Página em HTML: https://fontedata.com/docs/processos-judiciais/processos-agrupada
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp