Brazil CNPJ Legal Processes Detail - Individual Lawsuits

What does Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details do?

Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details returns the individual lawsuit records of Brazilian companies using a Brazilian company tax ID (CNPJ): case number, court, subject, status, monetary value, distribution date, latest movement date and party list, consolidated from official credentialed sources over the last 5 years, capturing records where the company appears as defendant or respondent. Each company can be limited with qtdMaxProcessos; the default is 30 lawsuits. Pagination is sequential: each response includes a cursorProximaPagina token you feed into the next run to advance one page at a time.

Only need aggregated totals and statistics by type, court, status or state? Use Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary instead. It covers that use case without pagination.

Built for due diligence, supplier onboarding, credit decisions and legal compliance workflows.

Why use Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details?

• 🔍 Case-level resolution: see each lawsuit individually, including number, court, subject, value, status and parties, not just totals.
• 📄 Controlled volume per company: use qtdMaxProcessos to limit the number of lawsuits returned for each CNPJ.
• 🏢 Batch first-page lookups: query up to 100 CNPJs at once for their first page. This is ideal for initial screening across a vendor or prospect list.
• 🔒 Privacy-compliant party data: companies keep full name and CNPJ (public record); individuals have names omitted and CPFs masked per LGPD.
• ⚡ API-first design: run synchronously via the Apify REST API, schedule recurring checks, or integrate via webhooks and native connectors (Zapier, Make, n8n).
• 📊 Flexible exports: download the Dataset as JSON, CSV, Excel or XML.

Common use cases:

• M&A and investment due diligence: review individual cases before signing a term sheet or closing a deal.
• Supplier onboarding: inspect the actual lawsuits behind an elevated litigation count flagged by a summary check.
• Credit and lending underwriting: assess legal exposure during credit analysis.
• Ongoing compliance monitoring: schedule periodic checks for key counterparties and receive alerts when new pages appear.
• Legal research and consulting: gather structured lawsuit data across multiple companies for comparative analysis.

How to use Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details

First page (no cursor)

1. Open the Actor in the Apify Console.
2. In the Input tab, enter one or more CNPJs in cnpjs (with or without mask; up to 100 at once).
3. Leave cursor empty.
4. Optionally set qtdMaxProcessos to cap the number of lawsuits returned for each company.
5. Click Start and wait for the run to complete.
6. Open the Output tab → switch to Todos os campos for the full record, or download via JSON / CSV / Excel / XML.

Subsequent pages (with cursor)

1. After the run finishes, locate the paginacao.cursorProximaPagina value in the output record.
2. Start a new run with exactly 1 CNPJ and paste that token into the cursor field.
3. Repeat until paginacao.temMaisPaginas is false.

⚠️ The source only supports sequential pagination. You cannot jump to an arbitrary page number. You must advance one page at a time using the cursor token returned by each response.

Input

Field	Required	Default	Description
cnpjs	✅ Yes	sample	Array of CNPJs to query (with or without mask). Max 100 without cursor; exactly 1 with cursor.
cursor	No	None	Opaque pagination token from paginacao.cursorProximaPagina. When set, requires exactly 1 CNPJ.
qtdMaxProcessos	No	30	Maximum number of individual lawsuits returned for each CNPJ. Integer from 1 to 1000.

{ "cnpjs": ["33.000.167/0001-01", "02.342.260/0001-70"], "qtdMaxProcessos": 30 }

{ "cnpjs": ["33.000.167/0001-01"], "cursor": "eyJwYWdpbmEiOjIsInRva2VuIjoiLi4uIn0" }

Output

One record is written to the Dataset per CNPJ per page requested. You can download the dataset as JSON, HTML, CSV or Excel. The API returns the complete JSON structure.

{
  "cnpj": "02342260000170",
  "cnpjFormatado": "02.342.260/0001-70",
  "consultadoEm": "2026-08-25T20:33:29.132Z",
  "encontrado": true,
  "erro": null,
  "processos": [
    {
      "numero": "50222990720214036182",
      "tipo": "EXECUCAO FISCAL",
      "assuntoPrincipal": "DIREITO TRIBUTARIO - IRPJ/IMPOSTO DE RENDA DE PESSOA JURIDICA",
      "tribunal": "JFSP",
      "instancia": "1",
      "tipoTribunal": "TRIBUTARIA",
      "uf": "SP",
      "status": "EXTINTO",
      "valor": null,
      "dataDistribuicao": "2021-09-22",
      "ultimaMovimentacao": "2026-08-10",
      "partes": [
        {
          "tipoPessoa": "empresa",
          "nome": "UNIAO FEDERAL FAZENDA NACIONAL",
          "documento": "03.566.231/0001-55",
          "tipo": "CLAIMANT",
          "polaridade": "ACTIVE"
        },
        {
          "tipoPessoa": "empresa",
          "nome": "EMPRESA EXEMPLO LTDA",
          "documento": "02.342.260/0001-70",
          "tipo": "CLAIMED",
          "polaridade": "PASSIVE"
        }
      ]
    }
  ],
  "paginacao": {
    "paginaAtual": 1,
    "totalPaginas": 2,
    "totalProcessos": 73,
    "temMaisPaginas": true,
    "cursorProximaPagina": "eyJwYWdpbmEiOjIsInRva2VuIjoiLi4uIn0"
  }
}

Data fields

Field	Type	Description
cnpj	string	CNPJ without mask (14 digits)
cnpjFormatado	string	CNPJ formatted as XX.XXX.XXX/XXXX-XX
consultadoEm	string	ISO 8601 UTC timestamp of the query
encontrado	boolean	true if the CNPJ has lawsuit records
erro	string/null	Error message if the query failed; null otherwise
processos[].numero	string	Lawsuit case number
processos[].tipo	string/null	Case type (e.g. EXECUCAO FISCAL)
processos[].assuntoPrincipal	string/null	Primary subject/matter
processos[].tribunal	string/null	Court abbreviation (e.g. JFSP, TJSP)
processos[].instancia	string/null	Court instance (1, 2, …)
processos[].tipoTribunal	string/null	Court type (TRIBUTARIA, TRABALHISTA, etc.)
processos[].uf	string/null	State where the case was filed
processos[].status	string/null	Case status (ATIVO, EXTINTO, etc.)
processos[].valor	number/null	Case monetary value in BRL; null if not specified
processos[].dataDistribuicao	string/null	Distribution date (YYYY-MM-DD)
processos[].ultimaMovimentacao	string/null	Date of the latest movement (YYYY-MM-DD)
processos[].partes[].tipoPessoa	string	empresa or pessoa
processos[].partes[].nome	string/null	Company name; null for individuals (LGPD)
processos[].partes[].documento	string/null	Company CNPJ or masked individual CPF
processos[].partes[].tipo	string/null	Party role: AUTHOR, DEFENDANT, LAWYER, etc.
processos[].partes[].polaridade	string/null	ACTIVE, PASSIVE or NEUTRAL
paginacao.paginaAtual	integer	This page's number (1 = first page)
paginacao.totalPaginas	integer/null	Estimated total pages
paginacao.totalProcessos	integer/null	Total lawsuits found
paginacao.temMaisPaginas	boolean	true if there are more pages to fetch
paginacao.cursorProximaPagina	string/null	Paste into cursor input to fetch the next page

Tips and advanced options

• Screen first with summary statistics, then inspect flagged companies: use Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary to batch-check hundreds of companies for total lawsuit counts, then drill into individual cases with this Actor only for the ones that exceed your risk threshold. This approach reduces the number of pages delivered and keeps costs proportional to risk exposure.
• Iterate through all pages in a script: collect cursorProximaPagina from each run, start a new run with exactly 1 CNPJ and the cursor token, and stop when temMaisPaginas is false. A simple loop in Python or Node.js handles this cleanly.
• Control the result size: set qtdMaxProcessos to return only the first N individual lawsuits for each company. The limit applies independently to every CNPJ in the input.

Pricing / Cost estimation

Each individual lawsuit returned in processos is one charged result. The parties nested inside that lawsuit are included in the same result and are not charged separately. For example, two CNPJs with qtdMaxProcessos: 2 can return up to four lawsuits and therefore up to four charged results. Companies that cannot be answered by the source produce no Dataset record and are not charged.

# First page via Apify REST API
curl -X POST "https://api.apify.com/v2/acts/brasildados~cnpj-lawsuits-detail/run-sync-get-dataset-items?format=json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33.000.167/0001-01"]}'

# Subsequent page: paste the cursorProximaPagina value from the previous response
curl -X POST "https://api.apify.com/v2/acts/brasildados~cnpj-lawsuits-detail/run-sync-get-dataset-items?format=json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33.000.167/0001-01"],"cursor":"eyJwYWdpbmEiOjIsInRva2VuIjoiLi4uIn0"}'

• Schedule recurring checks: set up a scheduled run in the Apify Console for key counterparties. Receive new lawsuit pages as they become available without manual intervention.
• Combine with webhooks: trigger downstream actions (Slack alert, CRM update, email) automatically when a run delivers new pages.
• Download in bulk: the Apify API returns the full Dataset in JSON, CSV, Excel or XML. Pass ?format=csv or ?format=xlsx on the run-sync endpoint.

FAQ, disclaimers and support

Can I jump straight to page 5? No. The source only supports sequential pagination. Start without cursor (page 1), then advance one page at a time by feeding each response's cursorProximaPagina back into the next run.

Which party roles are included? Lawsuits where the company appears as defendant or respondent, captured over the last 5 years.

What if processos is an empty array but erro is null? The CNPJ was queried successfully and has no lawsuits matching the filter in this window. encontrado will be false.

How is the result charged? Each individual lawsuit in processos is charged separately. The parties nested in a lawsuit are included in that same result and are not charged separately. Set qtdMaxProcessos to control the maximum number returned for each company. CNPJs that the source cannot answer produce no Dataset record and are not charged.

Why is the individual's name null in partes? Individual names are omitted per LGPD data protection rules. Company names and CNPJs remain full (public record). Individual CPFs are masked.

What data source does this Actor use? It consolidates from credentialed official Brazilian judicial sources. The 5-year window reflects the source's available history for defendant/respondent records.

Is it legal to use this data? Judicial records are public in Brazil. Use the data with a legitimate business purpose and comply with applicable regulations (LGPD/GDPR where personal data appears in party records).

Something wrong or missing? Open an issue on the Actor's Issues tab in the Apify Store. For custom integrations or high-volume use cases, contact: contato@brasildados.org.

---

🇧🇷 Resumo em português

Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details é um scraper e API que retorna os processos individuais de empresas brasileiras usando o Brazilian company tax ID (CNPJ), com número, tribunal, assunto, situação, valor e partes, nos últimos 5 anos como réu ou reclamado. Use qtdMaxProcessos para limitar a quantidade por empresa. A paginação da fonte é sequencial. Não dá para pular para uma página arbitrária. Avance usando o cursor devolvido em cada resposta. Até 100 CNPJs na primeira consulta, exatamente 1 ao usar cursor. CNPJs que a fonte não consegue responder ficam registrados no log sem gerar linha no Dataset. Cada processo retornado é uma unidade cobrada. As partes não são cobradas separadamente. Só precisa dos totais e estatísticas? Use o Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary, mais econômico para esse caso.

Actors relacionados

Actor	Quando usar
Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary	Triagem em lote com totais e estatísticas por tipo, tribunal, situação e estado
Brazil Sanctions Check: CPF and CNPJ	Verificação de sanções federais (CEIS, CNEP, CEPIM, CEAF)
Brazil Government Contracts Check	Verificação do histórico da empresa como fornecedora do governo

🛒 Todos os Actors: apify.com/brasildados

---

📧 contato@brasildados.org · 🌐 brasildados.org · 🛒 BrasilDados na Apify Store