# CNPJ Compliance Check - Brazil Company Due Diligence (`brasildados/cnpj-compliance-check`) Actor Enrich up to 2,000 CNPJs per run with 8 data modules: company data, shareholders (QSA), Simples Nacional, tax regime, CEIS, CNEP, CEPIM and Leniency Agreements. Pay per CNPJ. - **URL**: https://apify.com/brasildados/cnpj-compliance-check.md - **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community) - **Categories:** Lead generation, AI, Automation - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## CNPJ Compliance Check - Brazil Company Due Diligence The most complete CNPJ enrichment tool on Apify. Get company data, shareholders (QSA), Simples Nacional, tax regime, and sanctions (CEIS, CNEP, CEPIM, Leniency Agreements) in a single request. Process up to 2,000 CNPJs per run. Goes beyond basic Receita Federal lookups by cross-referencing 4 government sanctions databases and tax regime records, delivering compliance-ready data for KYC/KYB, supplier verification, and due diligence workflows. --- **A ferramenta de enriquecimento de CNPJ mais completa do Apify.** Dados cadastrais, quadro societário (QSA), Simples Nacional, regime tributário e sanções (CEIS, CNEP, CEPIM, Acordos de Leniência) em uma única consulta. Processa até 2.000 CNPJs por execução. Vai além da consulta básica da Receita Federal ao cruzar com 4 bases de sanções governamentais e dados de regime tributário, entregando dados prontos para compliance, KYC/KYB, verificação de fornecedores e due diligence. ### What data does it return? / Quais dados retorna? Each CNPJ returns one record per establishment (full 14-digit CNPJ), with `matriz: true/false` flag. Shareholders, Simples Nacional, tax regime and sanctions data are linked only to the headquarters (matriz) to avoid duplication. Cada CNPJ retorna um registro por estabelecimento (CNPJ completo de 14 dígitos), com flag `matriz: true/false`. Sócios, Simples Nacional, regime tributário e sanções são vinculados apenas na matriz. #### 8 data modules / 8 módulos de dados | Module | Data / Dados | |--------|------| | **cadastral** | Legal name, trade name, legal nature, share capital, company size, status, start date, full address, phone, email, primary + secondary CNAEs with descriptions, company age in years/days | | **socios** | Full shareholder list (QSA) with name, type (PF/PJ), document, role code + description (68 role types), entry date, legal representative | | **simples** | Simples Nacional and MEI opt-in status with start/end dates | | **regime-tributario** | Tax regime: Lucro Real, Lucro Presumido, Lucro Arbitrado, Imune, Isento, and combined regimes | | **ceis** | CEIS (Cadastro de Empresas Inidôneas e Suspensas): companies banned from government contracts | | **cnep** | CNEP (Cadastro Nacional de Empresas Punidas): companies penalized under the Anti-Corruption Law | | **cepim** | CEPIM (Cadastro de Entidades Privadas Sem Fins Lucrativos Impedidas): NGOs blocked from receiving public funds | | **acordos-leniencia** | Leniency Agreements: companies under leniency deals with the government | Sanctions are automatically filtered: records from before the company's founding date are excluded (the Brazilian IRS reuses CNPJ numbers from dissolved companies). Sanções são filtradas automaticamente: registros anteriores à data de fundação da empresa são removidos (a Receita Federal reutiliza números de CNPJ de empresas encerradas). ### Use cases / Casos de uso - **KYC/KYB & Due Diligence**: Verify company status, shareholders, and sanctions before onboarding clients or partners - **Supplier verification**: Check if suppliers have active sanctions or penalties before contracting - **Lead enrichment**: Enrich B2B leads with company size, activity codes, tax regime, and shareholder count - **Compliance monitoring**: Batch-check your vendor base against 4 government sanctions databases in one call - **Market research**: Analyze companies by CNAE, legal nature, share capital, tax regime, and location - **Risk scoring**: Combine sanctions, company age, status, and shareholder data to build risk models ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | cnpjs | string[] | Yes | List of CNPJs (formatted or unformatted). Max 2,000 per run. / Lista de CNPJs. Máximo 2.000 por execução. | | modules | string[] | No | Data modules to include. Default: all 8 modules. / Módulos de dados. Padrão: todos os 8 módulos. | | includeFiliais | boolean | No | Include branch offices. Default: false (headquarters only). / Incluir filiais. Padrão: false (apenas matriz). | ### Output example / Exemplo de output ```json { "cnpj": "33000167000101", "cnpjFormatado": "33.000.167/0001-01", "matriz": true, "consultadoEm": "2026-05-11T14:00:00.000Z", "razaoSocial": "PETROLEO BRASILEIRO S A PETROBRAS", "nomeFantasia": "PETROBRAS", "naturezaJuridica": "2046", "naturezaJuridicaDescricao": "Sociedade Anônima Aberta", "capitalSocial": "205.431.960.490,52", "capitalSocialNumerico": 205431960490.52, "porte": "05", "porteDescricao": "Demais", "qualificacaoResponsavel": "05", "qualificacaoResponsavelDescricao": "Administrador", "enteFederativo": null, "situacaoCadastral": "02", "situacaoCadastralDescricao": "Ativa", "dataSituacaoCadastral": "03/11/2005", "motivoSituacaoCadastral": "00", "motivoSituacaoCadastralDescricao": "Sem motivo", "dataInicioAtividade": "28/09/1966", "situacaoEspecial": null, "dataSituacaoEspecial": null, "cnaePrincipal": { "codigo": "1921700", "descricao": "Fabricação de produtos do refino de petróleo" }, "cnaesSecundarios": [ { "codigo": "0600001", "descricao": "Extração de petróleo e gás natural" }, { "codigo": "3520401", "descricao": "Produção de gás" } ], "tipoLogradouro": "AVENIDA", "logradouro": "REPUBLICA DO CHILE", "numero": "65", "complemento": null, "bairro": "CENTRO", "cep": "20031912", "uf": "RJ", "ufNome": "Rio de Janeiro", "municipioCodigo": "6001", "municipioNome": "RIO DE JANEIRO", "telefone1": "2132242164", "email": "ATENDIMENTOFISCAL@PETROBRAS.COM.BR", "enderecoCompleto": "AVENIDA REPUBLICA DO CHILE, 65, CENTRO, RIO DE JANEIRO/RJ, 20031912", "idadeEmpresaAnos": 59, "idadeEmpresaDias": 21609, "tempoSituacaoAtualDias": 7494, "totalSocios": 11, "totalCnaesSecundarios": 25, "tempoMedioSociosDias": 985, "socios": [ { "nome": "MAGDA MARIA DE REGINA CHAMBRIARD", "tipo": "2", "tipoDescricao": "Pessoa Física", "documento": "***456789**", "qualificacao": "10", "qualificacaoDescricao": "Diretor", "dataEntrada": "24/05/2024" } ], "simples": { "optanteSimples": false, "dataOpcaoSimples": null, "dataExclusaoSimples": null, "optanteMei": false, "dataOpcaoMei": null, "dataExclusaoMei": null }, "regimeTributario": "Lucro Real", "sancoes": { "ceis": [], "cnep": [], "cepim": [], "acordosLeniencia": [], "possuiSancaoAtiva": false, "totalSancoes": 0 } } ```` ### Why use this tool / Por que usar esta ferramenta - **8 data modules in one call**: Company data, shareholders, Simples Nacional, tax regime, and 4 sanctions databases, all in a single request - **Compliance-ready output**: Clear sanction flags, shareholder details, and computed fields ready for your compliance workflows - **Both CPF and CNPJ**: Screen companies and their shareholders in one place - **Smart sanctions filtering**: Automatically excludes sanctions from before the company's founding date (the Brazilian IRS reuses CNPJ numbers) - **Up to 2,000 CNPJs per run**: Process your entire vendor or client base in minutes *** - **8 módulos em uma chamada**: Dados cadastrais, sócios, Simples Nacional, regime tributário e 4 bases de sanções, tudo em uma única requisição - **Output pronto para compliance**: Flags de sanção claros, detalhes societários e campos calculados prontos para seus fluxos de compliance - **CPF e CNPJ**: Consulte empresas e seus sócios em um só lugar - **Filtragem inteligente de sanções**: Exclui automaticamente sanções anteriores à data de fundação da empresa (a Receita Federal reutiliza números de CNPJ) - **Até 2.000 CNPJs por execução**: Processe toda a sua base de fornecedores ou clientes em minutos ### Pricing / Preços **$0.001 per CNPJ** ($1.00 per 1,000 CNPJs). Apify platform costs apply separately. **$0.001 por CNPJ** ($1.00 por 1.000 CNPJs). Custos da plataforma Apify são cobrados separadamente. ### Data sources / Fontes de dados - **Receita Federal do Brasil**: Company registration, shareholders, Simples Nacional - **CGU (Controladoria-Geral da União)**: CEIS, CNEP, CEPIM, Leniency Agreements - **Tax regime records**: Lucro Real, Lucro Presumido, Lucro Arbitrado, Imune, Isento Data is updated periodically from official government databases. / Dados atualizados periodicamente a partir de bases governamentais oficiais. ### Related / Relacionados - **[Brazil Sanctions Check](https://apify.com/brasildados/sanctions-check)**: Lightweight sanctions-only screening for CPFs and CNPJs against 5 government databases (includes FGTS Debtors). Use this when you only need sanction screening without full company enrichment. / Screening leve de sanções para CPFs e CNPJs em 5 bases governamentais (inclui Devedores FGTS). Use quando precisar apenas do screening de sanções sem enriquecimento completo da empresa. # Actor input Schema ## `cnpjs` (type: `array`): List of CNPJs to query. Accepts formatted or unformatted (e.g. '33.000.167/0001-01' or '33000167000101'). Max 2,000 per run. | Lista de CNPJs para consulta. Aceita com ou sem formatacao. Maximo 2.000 por execucao. ## `modules` (type: `array`): Which modules to include. 'cadastral' = company data + address. 'socios' = shareholders (QSA). 'simples' = Simples/MEI. 'ceis' = sanctioned companies. 'cnep' = penalized companies. 'cepim' = blocked entities. 'acordos-leniencia' = leniency agreements. 'regime-tributario' = tax regime. ## `includeFiliais` (type: `boolean`): If true, returns all establishments (headquarters + branches). If false, returns only headquarters. | Se true, retorna todos os estabelecimentos (matriz + filiais). Se false, retorna apenas a matriz. ## Actor input object example ```json { "cnpjs": [ "33000167000101" ], "modules": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario" ], "includeFiliais": false } ``` # Actor output Schema ## `results` (type: `string`): Dataset with one record per CNPJ establishment, including company data, shareholders (QSA), Simples Nacional, tax regime, and sanctions (CEIS, CNEP, CEPIM, Leniency Agreements). # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "cnpjs": [ "33000167000101" ], "modules": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario" ] }; // Run the Actor and wait for it to finish const run = await client.actor("brasildados/cnpj-compliance-check").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "cnpjs": ["33000167000101"], "modules": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario", ], } # Run the Actor and wait for it to finish run = client.actor("brasildados/cnpj-compliance-check").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": [ "33000167000101" ], "modules": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario" ] }' | apify call brasildados/cnpj-compliance-check --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brasildados/cnpj-compliance-check", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CNPJ Compliance Check - Brazil Company Due Diligence", "description": "Enrich up to 2,000 CNPJs per run with 8 data modules: company data, shareholders (QSA), Simples Nacional, tax regime, CEIS, CNEP, CEPIM and Leniency Agreements. Pay per CNPJ.", "version": "1.0", "x-build-id": "AVaj8ca1lK3kn746g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brasildados~cnpj-compliance-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brasildados-cnpj-compliance-check", "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-compliance-check/runs": { "post": { "operationId": "runs-sync-brasildados-cnpj-compliance-check", "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-compliance-check/run-sync": { "post": { "operationId": "run-sync-brasildados-cnpj-compliance-check", "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" ], "properties": { "cnpjs": { "title": "CNPJs", "type": "array", "description": "List of CNPJs to query. Accepts formatted or unformatted (e.g. '33.000.167/0001-01' or '33000167000101'). Max 2,000 per run. | Lista de CNPJs para consulta. Aceita com ou sem formatacao. Maximo 2.000 por execucao.", "items": { "type": "string" } }, "modules": { "title": "Data modules / Modulos de dados", "type": "array", "description": "Which modules to include. 'cadastral' = company data + address. 'socios' = shareholders (QSA). 'simples' = Simples/MEI. 'ceis' = sanctioned companies. 'cnep' = penalized companies. 'cepim' = blocked entities. 'acordos-leniencia' = leniency agreements. 'regime-tributario' = tax regime.", "items": { "type": "string", "enum": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario" ] }, "default": [ "cadastral", "socios", "simples", "ceis", "cnep", "cepim", "acordos-leniencia", "regime-tributario" ] }, "includeFiliais": { "title": "Include branches / Incluir filiais", "type": "boolean", "description": "If true, returns all establishments (headquarters + branches). If false, returns only headquarters. | Se true, retorna todos os estabelecimentos (matriz + filiais). Se false, retorna apenas a matriz.", "default": false } } }, "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 } } } } } } } } } } ```