# Brazil CNPJ Due Diligence Report - Company Background Check (`brasildados/cnpj-due-diligence-report`) Actor

Due diligence dossier per Brazilian CNPJ by email: registration, owners, court lawsuits (defendant/plaintiff), government debts, sanctions/PEP. Vetting, KYC, credit. Standby POST /check. | Dossiê de due diligence por CNPJ por email: cadastro, sócios, processos, dívidas, sanções/PEP.

- **URL**: https://apify.com/brasildados/cnpj-due-diligence-report.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** Automation, Lead generation, E-commerce
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $700.00 / 1,000 per due diligence report mail sent (one per cnpj tax id)s

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Brazil CNPJ Due Diligence Report - by E-mail

Gere um dossiê de due diligence completo de qualquer empresa brasileira (CNPJ) e receba na hora por e-mail. Você informa os CNPJs e os e-mails que devem receber; cada CNPJ vira um relatório HTML profissional entregue por e-mail, e os mesmos dados também voltam em JSON no dataset. **E, se você agendar, ele vira um monitor contínuo da sua carteira de CNPJs.**

> Generate a complete due diligence dossier for any Brazilian company (CNPJ) and receive it by e-mail instantly. You provide the CNPJs and the recipient e-mails; each CNPJ becomes a professional HTML report delivered by e-mail, with the same data also available as JSON in the dataset. **And if you schedule it, it becomes a continuous monitor of your CNPJ portfolio.**

### Veja o relatório / See the report

Relatório de due diligence de CNPJ tem muito por aí. O nosso diferencial é o **relatório em si**: visual, organizado e pronto para decisão, direto no e-mail do cliente.

> Plenty of CNPJ due diligence tools exist. Our edge is the report itself: visual, organized and decision-ready, straight to the recipient's inbox.

![Exemplo do relatório de due diligence / Sample due diligence report](https://brasildados.org/dossie-due-diligence-exemplo.png)

### O que vem no dossiê / What's in the dossier

- **Identificação**: razão social, nome fantasia, situação cadastral, abertura e idade, natureza, porte, capital, regime tributário, Simples, CNAE principal e secundários, inscrições estaduais, endereço e contato.
- **Quadro societário (QSA)**: sócios, papel e data de entrada.
- **Processos judiciais**: total e divisão como réu / como autor, atividade recente (novos em 30/90/365 dias) e os 30 mais recentes, com número CNJ, polo, valor, assunto, foro/UF, situação e última movimentação.
- **Dívidas com o governo**: dívida ativa total, número de inscrições, % ajuizadas, inscrição mais antiga, e duas tabelas (10 maiores e 10 mais recentes) com tributo, valor, situação, UF e data.
- **Sanções e exposição política**: PEP, sanções, histórico e doações eleitorais.

> **Registration**: legal name, trade name, status, founding date and age, legal nature, size, capital, tax regime, Simples, main and secondary activities, state registrations, address and contact.
> **Owners (QSA)**: shareholders, role and start date.
> **Lawsuits**: total and split as defendant / plaintiff, recent activity (new in 30/90/365 days) and the 30 most recent, with CNJ number, role, amount, subject, court/state, status and latest movement.
> **Government debts**: total active debt, number of registrations, % filed in court, oldest registration, and two tables (top 10 by value and 10 most recent) with tax, amount, status, state and date.
> **Sanctions and political exposure**: PEP, sanctions, history and electoral donations.

### Como usar / How to use

Informe os CNPJs e os e-mails. Cada CNPJ encontrado gera um e-mail com o relatório completo e um registro JSON no dataset.

> Provide the CNPJs and the e-mails. Each CNPJ found generates one e-mail with the full report and one JSON record in the dataset.

```json
{
  "cnpjs": ["71673990000177", "33.000.167/0001-01"],
  "emails": ["seu-email@empresa.com"]
}
````

- `cnpjs`: lista de CNPJs (com ou sem máscara). Máximo 1.000 por execução. CNPJs com dígito verificador inválido são descartados e não são cobrados.
- `emails`: quem recebe o dossiê de cada CNPJ.

### Monitore uma carteira de CNPJs / Monitor a portfolio of CNPJs

Agende este Actor (em **Schedules**, na Apify) com a sua lista de CNPJs e e-mails e receba os dossiês automaticamente no intervalo que escolher (diário, semanal, mensal). Assim a due diligence pontual vira um **monitoramento contínuo da sua carteira** de fornecedores, clientes ou contrapartes: a cada execução agendada, os destinatários recebem o relatório atualizado, sem você precisar lembrar de rodar.

> Schedule this Actor (in **Schedules**, on Apify) with your list of CNPJs and e-mails and receive the dossiers automatically at the interval you choose (daily, weekly, monthly). One-off due diligence becomes **continuous monitoring of your portfolio** of vendors, clients or counterparties: on each scheduled run the recipients get the updated report, with nothing to remember.

### API (Standby)

Endpoint síncrono `POST /check` com o mesmo corpo do input. Retorna um array com um resultado por CNPJ e dispara os e-mails. Aceita `Accept-Encoding: gzip`.

> Synchronous `POST /check` endpoint with the same body. Returns one result per CNPJ and sends the e-mails.

### Casos de uso / Use cases

Homologação de fornecedores e contrapartes, KYC/AML, análise de crédito e onboarding, pré-M\&A e auditoria. Dados consolidados de fontes públicas oficiais: entregamos os fatos normalizados e a decisão é da regra de negócio do cliente.

> Vendor and counterparty vetting, KYC/AML, credit and onboarding, pre-M\&A and audit. Data consolidated from official public sources: we deliver normalized facts and the decision stays with the client's business rules.

### Privacidade / Privacy

O relatório traz dados públicos da empresa consultada. Não expomos CPF de terceiros nem o texto integral de decisões judiciais.

> The report contains public data about the queried company. We do not expose third-party tax IDs or the full text of court decisions.

# Actor input Schema

## `cnpjs` (type: `array`):

List of CNPJs to investigate (any format). Max 1,000 per run. Invalid check digits are skipped. | Lista de CNPJs a investigar (qualquer formato). Máximo 1.000 por execução. Inválidos são ignorados.

## `emails` (type: `array`):

E-mail address(es) that will receive the dossier for each CNPJ. | E-mail(s) que receberão o dossiê de cada CNPJ.

## Actor input object example

```json
{
  "cnpjs": [
    "71673990000177",
    "33.000.167/0001-01"
  ],
  "emails": [
    "seu-email@empresa.com"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

One record per CNPJ with the structured dossier. | Um registro por CNPJ com o dossiê estruturado.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cnpjs": [
        "71673990000177",
        "33.000.167/0001-01"
    ],
    "emails": [
        "seu-email@empresa.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/cnpj-due-diligence-report").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "cnpjs": [
        "71673990000177",
        "33.000.167/0001-01",
    ],
    "emails": ["seu-email@empresa.com"],
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/cnpj-due-diligence-report").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cnpjs": [
    "71673990000177",
    "33.000.167/0001-01"
  ],
  "emails": [
    "seu-email@empresa.com"
  ]
}' |
apify call brasildados/cnpj-due-diligence-report --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=brasildados/cnpj-due-diligence-report",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Brazil CNPJ Due Diligence Report - Company Background Check",
        "description": "Due diligence dossier per Brazilian CNPJ by email: registration, owners, court lawsuits (defendant/plaintiff), government debts, sanctions/PEP. Vetting, KYC, credit. Standby POST /check. | Dossiê de due diligence por CNPJ por email: cadastro, sócios, processos, dívidas, sanções/PEP.",
        "version": "1.0",
        "x-build-id": "lmtqONDDSnuDD9hzp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/brasildados~cnpj-due-diligence-report/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-brasildados-cnpj-due-diligence-report",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/brasildados~cnpj-due-diligence-report/runs": {
            "post": {
                "operationId": "runs-sync-brasildados-cnpj-due-diligence-report",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/brasildados~cnpj-due-diligence-report/run-sync": {
            "post": {
                "operationId": "run-sync-brasildados-cnpj-due-diligence-report",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "cnpjs",
                    "emails"
                ],
                "properties": {
                    "cnpjs": {
                        "title": "CNPJs",
                        "minItems": 1,
                        "maxItems": 1000,
                        "type": "array",
                        "description": "List of CNPJs to investigate (any format). Max 1,000 per run. Invalid check digits are skipped. | Lista de CNPJs a investigar (qualquer formato). Máximo 1.000 por execução. Inválidos são ignorados.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "emails": {
                        "title": "E-mails / Destinatários",
                        "minItems": 1,
                        "type": "array",
                        "description": "E-mail address(es) that will receive the dossier for each CNPJ. | E-mail(s) que receberão o dossiê de cada CNPJ.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```