Brazil CNPJ Legal Processes Scraper Lawsuits & Litigation Risk

⚖️ What is CNPJ Legal Processes Check?

CNPJ Lawsuits Check returns legal processes and litigation risk for Brazilian companies by CNPJ: aggregated lawsuit statistics plus optional individual case records (incluirProcessos). Totals by process type, court, UF, status and party role over the last 5 years as defendant/respondent. Up to 1,000 CNPJs per summary run, export to JSON, CSV, Excel or XML, or call the REST API in real time.

Summary by default; case details optional. Set incluirProcessos: true for process numbers, court, status, value and parties. Use tokenPagina to paginate. Ideal for litigation risk screening, compliance and due diligence.

What data can CNPJ Lawsuits Check extract?

📊 Totals	totalProcessos, encontrado, erro
📋 By type	distribuicao.porTipo (Civil, Labor, Criminal, Administrative)
🗺️ By state	distribuicao.porEstado (UF)
✅ By status	distribuicao.porStatus (Active, Closed, Suspended)
👤 By role	distribuicao.porTipoParticipacao (Defendant, Plaintiff, etc.)
🏛️ By court	porNomeTribunal, porTipoTribunal, porNivelTribunal
📑 CNJ taxonomy	porAssuntoCnj, porAssuntoCnjAbrangente, porTipoProcedimentoCnj
📄 Case records	processos[] when incluirProcessos: true (number, court, status, value, parties)
🔁 Pagination	paginacao (retornados, totalReportado, temMais, tokenProximaPagina)
🕐 Metadata	cnpj, cnpjFormatado, consultadoEm

What can this Actor do?

• ⚖️ Litigation risk snapshot: total exposure as defendant in one call
• 📄 Optional case details: incluirProcessos for individual records (up to 100 per page)
• 🔁 Pagination: follow tokenProximaPagina for additional pages (~3h validity)
• 🇧🇷 National coverage: civil, labor, criminal and administrative courts
• 📋 Bulk screening: up to 1,000 CNPJs (summary) or 100 (detail) per run
• 📤 Multiple exports: JSON, CSV, Excel, XML from Apify Dataset
• ⚡ Standby REST API: POST /check for real-time integration
• 🔗 Pipeline-ready: pair with Enrichment, Sanctions and KYC actors

Apify platform bonus: schedule recurring portfolio checks, monitor runs, webhooks, API access and MCP integration.

---

Why check Brazilian company lawsuits by CNPJ?

• M&A due diligence: assess labor and civil exposure before signing
• Supplier onboarding: block vendors with elevated litigation profiles
• Credit and lending: include judicial exposure in borrower risk models
• Portfolio monitoring: track partners or debtors periodically
• Regulatory compliance: flag companies with active criminal or administrative cases
• Risk scoring: feed totalProcessos and distribution buckets into automated rules

Consolidated from credentialed official sources. Aggregation window: last 5 years of captured processes as defendant/respondent.

---

How do I check lawsuit distribution in bulk?

1. Open the actor on Apify Console and go to the Input tab.
2. Paste CNPJs in the cnpjs string list (any format).
3. Click Start and wait for the run to finish.
4. Open Dataset > Export > choose XLSX, CSV or JSON.

Example input:

{
  "cnpjs": ["33.000.167/0001-01", "60.746.948/0001-12"]
}

Tip: combine with Sanctions Check for regulatory risk and KYC for PEP/sanctions depth.

---

⬇️ Input

Click the Input tab for the full schema.

Field	Required	Description
cnpjs	✅ Yes	CNPJs (string list). Max 1,000 (summary) or 100 (detail). Exactly 1 with tokenPagina. Invalid check digits skipped.
incluirProcessos	No	Default false. When true, returns up to maxProcessos case records per CNPJ. Charged at $1.00/CNPJ.
maxProcessos	No	Default 50, range 1–100. Used only when incluirProcessos is true.
tokenPagina	No	Pagination token from paginacao.tokenProximaPagina. Requires exactly 1 CNPJ. Charged at $0.75/CNPJ. Valid ~3 hours.

---

⬆️ Output

Download from Dataset tab. One record per valid CNPJ.

Abbreviated sample. Full output includes all distribuicao.* buckets when data is available. See Dataset schema for the complete list.

{
  "cnpj": "33000167000101",
  "cnpjFormatado": "33.000.167/0001-01",
  "consultadoEm": "2026-05-25T12:00:00.000Z",
  "encontrado": true,
  "erro": null,
  "totalProcessos": 4821,
  "distribuicao": {
    "porTipo": { "Civil": 2100, "Trabalhista": 1950, "Criminal": 480, "Administrativo": 291 },
    "porEstado": { "SP": 1820, "RJ": 1203, "MG": 654 },
    "porStatus": { "Ativo": 2900, "Encerrado": 1921 },
    "porTipoParticipacao": { "Réu": 3200, "Autor": 1621 },
    "porAssuntoCnjAbrangente": { "Direito do Trabalho": 1950, "Direito Civil": 2100 }
  }
}

High-volume companies: large banks or state-owned enterprises may return encontrado: true with distribuicao: null and erro: "volume excessivo de processos".

Complete field list: Dataset schema tab on Apify Console.

---

How much does lawsuit screening cost?

Mode	Price	Notes
Summary (default)	$0.20/CNPJ	Aggregated distribution only
Detail (incluirProcessos: true)	$1.00/CNPJ	First page of case records (up to maxProcessos)
Pagination (tokenPagina)	$0.75/CNPJ	Additional pages; token valid ~3 hours

Example: 150 case records (3×50 pages) = $2.50 ($1.00 + 2×$0.75).

Standby POST /check uses the same pricing. Pagination is charged only on successful responses.

---

🔌 API integration

Batch run:

curl -X POST "https://api.apify.com/v2/acts/brasildados~cnpj-lawsuits-check/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33.000.167/0001-01","60.746.948/0001-12"]}'

Standby (POST /check):

curl -X POST "https://brasildados--cnpj-lawsuits-check.apify.actor/check" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnpjs":["33.000.167/0001-01"]}'

Max 1,000 CNPJs (summary) or 100 (detail) per request. Interactive docs in the Endpoints tab.

---

Related Actors

Actor	When to use
CNPJ Enrichment	Company profile and QSA before judicial risk review
Sanctions Check	CEIS/CNEP/FGTS regulatory screening
CNPJ KYC & PEP Checker	PEP, international sanctions and electoral donations
Government Contracts Check	Public revenue concentration risk

Suggested pipeline: Enrichment → Lawsuits (this) → Sanctions → KYC

---

FAQ

Does it return individual lawsuit numbers?

Yes, when incluirProcessos is true (up to maxProcessos per CNPJ, default 50). Summary-only mode returns aggregated stats without case numbers.

Which party role is included?

Aggregation focuses on processes where the company appears as defendant/respondent (réu/reclamado), over the last 5 years.

What courts are covered?

Civil, labor, criminal and administrative proceedings nationwide (state, federal, labor and electoral courts).

What if distribuicao is null?

Usually erro: "volume excessivo de processos" for companies with extremely high litigation volume (large banks, major state-owned enterprises).

What CNPJ formats are accepted?

Any format. Check digits validated locally. Max 1,000 CNPJs (summary) or 100 (detail) per run.

Batch vs Standby limits?

Summary: up to 1,000 CNPJs. Detail: up to 100 CNPJs. Pagination (tokenPagina): exactly 1 CNPJ. Same limits for batch and POST /check.

Is it legal to use this data?

Use only with legitimate business purpose and applicable compliance requirements (LGPD/GDPR where personal data appears in aggregated buckets).

---

🇧🇷 Versão em português (Brasil)

⚖️ O que é a Consulta de Processos por CNPJ?

Consulta de Processos por CNPJ retorna processos legais e risco de litígio de empresas brasileiras por CNPJ: estatísticas agregadas de processos mais registros individuais opcionais (incluirProcessos). Totais por tipo, tribunal, UF, status e polo nos últimos 5 anos como réu/reclamado. Até 1.000 CNPJs por execução em resumo, exporte em JSON, CSV, Excel ou XML, ou integre via API REST em tempo real.

Resumo por padrão; detalhes opcionais. Use incluirProcessos: true para número, tribunal, status, valor e partes. Paginação com tokenPagina. Ideal para triagem de risco, compliance e due diligence.

Quais dados a distribuição processual retorna?

📊 Totais	totalProcessos, encontrado, erro
📋 Por tipo	distribuicao.porTipo (Cível, Trabalhista, Criminal, Administrativo)
🗺️ Por UF	distribuicao.porEstado
✅ Por status	distribuicao.porStatus (Ativo, Encerrado, Suspenso)
👤 Por polo	distribuicao.porTipoParticipacao (Réu, Autor, etc.)
🏛️ Por tribunal	porNomeTribunal, porTipoTribunal, porNivelTribunal
📑 Taxonomia CNJ	porAssuntoCnj, porAssuntoCnjAbrangente, porTipoProcedimentoCnj
📄 Processos individuais	processos[] com incluirProcessos: true (número, tribunal, status, valor, partes)
🔁 Paginação	paginacao (retornados, totalReportado, temMais, tokenProximaPagina)
🕐 Metadados	cnpj, cnpjFormatado, consultadoEm

O que este Actor faz?

• ⚖️ Snapshot de risco processual: exposição total como réu em uma chamada
• 📄 Detalhes opcionais: incluirProcessos para registros individuais (até 100 por página)
• 🔁 Paginação: use tokenProximaPagina para páginas adicionais (validade ~3h)
• 🇧🇷 Cobertura nacional: cível, trabalhista, criminal e administrativo
• 📋 Triagem em lote: até 1.000 CNPJs (resumo) ou 100 (detalhe) por execução
• 📤 Exportação múltipla: JSON, CSV, Excel, XML no Dataset Apify
• ⚡ API REST Standby: POST /check em tempo real
• 🔗 Pipeline: combine com Enriquecimento, Sanctions e KYC

Bônus Apify: agende verificações recorrentes, monitore execuções, webhooks, API e MCP.

---

Por que consultar processos judiciais por CNPJ?

• Due diligence M&A: avalie passivo trabalhista e cível antes de fechar
• Onboarding de fornecedores: bloqueie vendors com perfil processual elevado
• Crédito e financiamento: inclua exposição judicial no score do tomador
• Monitoramento de carteira: acompanhe parceiros ou devedores periodicamente
• Compliance regulatório: identifique processos criminais ou administrativos ativos
• Score de risco: use totalProcessos e buckets de distribuicao em regras automatizadas

Base consolidada de fonte oficial credenciada. Janela: últimos 5 anos como réu/reclamado.

---

Como consultar distribuição processual em lote?

1. Abra o actor no Console Apify > aba Input.
2. Cole os CNPJs na lista de strings cnpjs (qualquer formato).
3. Clique em Start e aguarde.
4. Dataset > Export > XLSX, CSV ou JSON.

---

⬇️ Entrada

Campo	Obrigatório	Descrição
cnpjs	✅ Sim	CNPJs (lista). Máx. 1.000 (resumo) ou 100 (detalhe). Exatamente 1 com tokenPagina. Inválidos ignorados.
incluirProcessos	Não	Padrão false. Com true, retorna até maxProcessos processos por CNPJ. Cobrança $1,00/CNPJ.
maxProcessos	Não	Padrão 50, faixa 1–100. Usado só com incluirProcessos: true.
tokenPagina	Não	Token de paginacao.tokenProximaPagina. Exige 1 CNPJ. Cobrança $0,75/CNPJ. Válido ~3 horas.

---

⬆️ Saída

Um registro por CNPJ válido na aba Dataset.

Amostra resumida. Saída completa inclui todos os buckets distribuicao.* quando disponíveis. Veja Dataset schema.

Empresas de alto volume: grandes bancos ou estatais podem retornar distribuicao: null e erro: "volume excessivo de processos".

---

Quanto custa consultar processos por CNPJ?

Modo	Preço	Notas
Resumo (padrão)	$0,20/CNPJ	Somente distribuição agregada
Detalhe (incluirProcessos: true)	$1,00/CNPJ	Primeira página de processos (até maxProcessos)
Paginação (tokenPagina)	$0,75/CNPJ	Páginas adicionais; token válido ~3 horas

Exemplo: 150 processos (3×50 páginas) = $2,50 ($1,00 + 2×$0,75).

Standby POST /check usa a mesma tabela. Paginação só cobra em resposta bem-sucedida.

---

🔌 Integração via API

Mesmos endpoints da seção em inglês acima. Máx. 1.000 CNPJs (resumo) ou 100 (detalhe) por requisição.

---

Actors relacionados

Actor	Quando usar
Enriquecimento CNPJ	Perfil cadastral e QSA antes da análise judicial
Sanctions Check	Triagem CEIS/CNEP/FGTS
KYC & PEP Checker	PEP, sanções internacionais e doações eleitorais
Consulta Contratos	Concentração de receita pública

Pipeline sugerido: Enriquecimento → Processos (este) → Sanctions → KYC

---

Perguntas frequentes

Retorna número de processo individual?

Sim, com incluirProcessos: true (até maxProcessos por CNPJ, padrão 50). Modo resumo retorna apenas estatísticas agregadas.

Qual polo entra na agregação?

Processos em que a empresa figura como réu/reclamado, nos últimos 5 anos.

Quais tribunais são cobertos?

Cível, trabalhista, criminal e administrativo em todo o Brasil (estadual, federal, trabalhista, eleitoral).

E se distribuicao vier null?

Geralmente erro: "volume excessivo de processos" em empresas com volume extremo (grandes bancos, estatais).

Quais formatos de CNPJ são aceitos?

Qualquer formato. Dígitos verificadores validados localmente. Máx. 1.000 CNPJs (resumo) ou 100 (detalhe) por execução.

Limites batch vs Standby?

Resumo: até 1.000 CNPJs. Detalhe: até 100 CNPJs. Paginação (tokenPagina): exatamente 1 CNPJ. Mesmos limites em batch e POST /check.

É legal usar esses dados?

Use com finalidade legítima e requisitos de compliance aplicáveis (LGPD/GDPR quando houver dados pessoais nos agregados).