# Histórico de Alterações da Empresa por CNPJ - API (`brasildados/historico-empresa-cnpj-api`) Actor

Informe uma lista de CNPJs e receba os dados cadastrais da empresa e o histórico dos últimos 5 anos: mudanças de capital social, razão social, atividades (CNAE), filiais, faixa de faturamento e quadro societário, em uma linha do tempo pronta.

- **URL**: https://apify.com/brasildados/historico-empresa-cnpj-api.md
- **Developed by:** [brasildados.org - API de Dados Abertos](https://apify.com/brasildados) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $800.00 / 1,000 por empresa analisadas

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Histórico da Empresa por CNPJ: alterações de capital, razão social, CNAE e filiais

Consulte o **histórico de alterações de qualquer empresa brasileira pelo CNPJ** e receba, em um único JSON, os **dados cadastrais atualizados** e uma **linha do tempo com até 5 anos de histórico**:

- aumentos e reduções de **capital social**;
- trocas de **razão social** e **nome fantasia**;
- inclusão e retirada de **atividades (CNAE)**;
- abertura e fechamento de **filiais**;
- mudança de **faixa de faturamento**;
- entrada de **sócios**.

Envie uma lista de CNPJs e receba um registro por empresa, pronto para usar em **due diligence, KYB, compliance, análise de crédito, homologação de fornecedores e prospecção B2B**.

#### O que este Actor faz

O cartão CNPJ mostra só a **foto atual** da empresa. Este Actor mostra **o filme**: como ela chegou até ali.

Alguns sinais que ficam visíveis só no histórico:

- **Empresa que entrou em recuperação judicial ou liquidação**: a razão social ganha o sufixo "em recuperação judicial" ou "em liquidação extrajudicial", com a data da mudança.
- **Troca de nome**: empresas que mudaram de razão social, por exemplo depois de uma aquisição ou reestruturação.
- **Capital social inflado de uma hora para outra**: saltos de R$ 1 mil para dezenas de milhões são comuns em SPEs e empresas de fachada.
- **Mudança de ramo**: inclusão ou retirada de CNAEs mostra quando a empresa passou a atuar em outra atividade.
- **Crescimento ou encolhimento**: abertura e fechamento de filiais e mudança de faixa de faturamento ao longo dos anos.

#### Para quem é

- **Compliance, KYC e KYB**: verificação de contrapartes, prevenção à fraude e à lavagem de dinheiro.
- **Análise de crédito**: contexto da trajetória da empresa antes de conceder limite.
- **Compras e homologação de fornecedores**: avaliar a estabilidade de quem vai fornecer para você.
- **Due diligence em M\&A e investimentos**: histórico societário e de capital do alvo.
- **Jurídico e auditoria**: datas de alterações cadastrais para instruir processos e relatórios.
- **Inteligência comercial e prospecção B2B**: empresas que estão crescendo, abrindo filiais ou ampliando atividades.
- **Desenvolvedores**: integração por API em sistemas próprios, CRMs, ERPs e esteiras de onboarding.

#### Dados retornados

A saída é **plana**: cada informação é um campo de primeiro nível, pronto para planilha, CSV ou banco de dados. Só as listas (sócios, CNAEs secundários e históricos) vêm como arrays.

| Grupo | Campos |
|---|---|
| **Empresa** | `cnpjRaiz`, `razaoSocial`, `nomeFantasia`, `abertura`, `idadeAnos`, `naturezaJuridicaCodigo`, `naturezaJuridica`, `enteFederativo`, `porteCodigo`, `porteSigla`, `porte`, `capitalSocial`, `matriz`, `dataAtualizacao` |
| **Situação cadastral** | `situacaoCodigo`, `situacao`, `situacaoDesde`, `motivoSituacaoCodigo`, `motivoSituacao` |
| **Situação especial** | `situacaoEspecialCodigo`, `situacaoEspecial`, `situacaoEspecialDesde` (ex.: recuperação judicial, falência, liquidação) |
| **Simples e MEI** | `simplesOptante`, `simplesDesde`, `meiOptante`, `meiDesde` |
| **Endereço** | `logradouro`, `numero`, `complemento`, `bairro`, `municipio`, `municipioIbge`, `uf`, `cep`, `pais`, `paisCodigo` |
| **Contatos** | `telefones` (número e tipo: fixo/celular), `emails` (e-mail, tipo: corporativo/pessoal/contabilidade, e domínio) |
| **Atividades** | `cnaePrincipalCodigo`, `cnaePrincipalDescricao`, `cnaesSecundarios` (código e descrição) |
| **Sócios** | `socios`: quadro societário atual, com nome, tipo (PF/PJ), qualificação e data de entrada |
| **Situação atual** | `funcionariosAtual`, `faixaFuncionariosAtual`, `faixaFaturamentoAtual`, `filiaisAtual`, `qtdSociosAtual` (mês mais recente) |
| **Período do histórico** | `historicoInicio`, `historicoFim`, `totalEventos` |
| **Linha do tempo** | `linhaDoTempo`: eventos datados em ordem cronológica, com tipo, descrição e valores "de → para" |
| **Histórico de nomes** | `historicoNomes`: todas as razões sociais e nomes fantasia, com a data de cada mudança |
| **Histórico de capital** | `historicoCapital`: cada valor de capital social, com a data em que passou a valer |
| **Série mensal** | `historicoMensal`: até 60 meses de capital, funcionários, filiais, nº de sócios, faixa de faturamento, faixa de funcionários e CNAEs |

##### Tipos de evento da linha do tempo

| `tipo` | Exemplo de `descricao` |
|---|---|
| `abertura` | Abertura da empresa na Receita Federal |
| `socio` | Entrada de Fulano de Tal (Sócio-Administrador) na sociedade |
| `simples` / `mei` | Opção pelo Simples Nacional |
| `situacaoEspecial` | Situação especial: Início de Recuperação Judicial |
| `situacao` | Situação cadastral passou a Baixada (Incorporação) |
| `razaoSocial` | Razão social alterada de "X LTDA" para "X LTDA - EM RECUPERACAO JUDICIAL" |
| `nomeFantasia` | Nome fantasia alterado de "A" para "B" |
| `capital` | Aumento do capital social de R$ 45.000.000,00 para R$ 129.000.000,00 |
| `cnaePrincipal` | Atividade principal passou a ser: … |
| `cnaeIncluido` / `cnaeRetirado` | Inclusão de 10 atividades secundárias, entre elas: … |
| `faturamento` | Faixa de faturamento estimada passou de acima de R$ 100 mi até R$ 250 mi para acima de R$ 250 mi até R$ 500 mi |
| `qtdSocios` | Quadro societário passou de 2 para 4 sócios |
| `filiais` | Número de filiais passou de 15 para 22 ao longo de 2022 |

Os eventos de capital, nomes, atividades, faturamento, sócios e filiais trazem os campos `de` e `para` com os valores brutos, para quem quer processar os dados em vez de ler o texto.

#### Como usar

1. Cole os CNPJs no campo **CNPJs**, com ou sem pontuação (até 50 por execução).
2. Clique em **Start**.
3. Baixe o resultado em **JSON, CSV, Excel ou XML**, ou consuma direto pela API.

CNPJs repetidos e CNPJs com dígito verificador inválido são ignorados automaticamente e não são cobrados.

##### Exemplo de entrada

```json
{
  "cnpjs": ["81.804.684/0001-86", "36503186000149"]
}
```

##### Exemplo de saída

Exemplo com dados fictícios. A estrutura e a ordem dos campos são exatamente as do resultado.

```json
{
  "cnpj": "99999999000191",
  "consultadoEm": "2026-10-11",
  "cnpjRaiz": "99999999",
  "dataAtualizacao": "2026-10-01",
  "razaoSocial": "EXEMPLO LOGISTICA LTDA",
  "nomeFantasia": "Exemplo Log",
  "situacaoCodigo": 4,
  "situacao": "Inapta",
  "situacaoDesde": "2026-09-15",
  "motivoSituacaoCodigo": 63,
  "motivoSituacao": "Omissão de Declarações",
  "situacaoEspecialCodigo": 418,
  "situacaoEspecial": "Início de Recuperação Judicial",
  "situacaoEspecialDesde": "2026-09-01",
  "abertura": "2026-05-04",
  "idadeAnos": 0,
  "naturezaJuridicaCodigo": "2062",
  "naturezaJuridica": "Sociedade Empresária Limitada",
  "enteFederativo": "União",
  "porteCodigo": 1,
  "porteSigla": "ME",
  "porte": "Microempresa",
  "capitalSocial": 150000,
  "matriz": true,
  "simplesOptante": true,
  "simplesDesde": "2026-05-04",
  "meiOptante": true,
  "meiDesde": "2026-05-04",
  "logradouro": "Rua Exemplo",
  "numero": "100",
  "complemento": "Sala 1",
  "bairro": "Centro",
  "municipio": "São Paulo",
  "municipioIbge": "3550308",
  "uf": "SP",
  "cep": "01001000",
  "pais": "Brasil",
  "paisCodigo": 76,
  "telefones": [
    { "numero": "(11) 30000000", "tipo": "fixo" }
  ],
  "emails": [
    { "email": "contato@exemplolog.com.br", "tipo": "corporativo", "dominio": "exemplolog.com.br" }
  ],
  "cnaePrincipalCodigo": "4930202",
  "cnaePrincipalDescricao": "Transporte rodoviário de carga, exceto produtos perigosos e mudanças, intermunicipal, interestadual e internacional",
  "cnaesSecundarios": [
    { "codigo": "4930201", "descricao": "Transporte rodoviário de carga, exceto produtos perigosos e mudanças, municipal" },
    { "codigo": "5250804", "descricao": "Organização logística do transporte de carga" }
  ],
  "socios": [
    { "nome": "Joao Exemplo da Silva", "tipo": "PF", "qualificacao": "Sócio-Administrador", "desde": "2026-05-04" },
    { "nome": "Maria Exemplo Souza", "tipo": "PF", "qualificacao": "Sócio", "desde": "2026-05-04" }
  ],
  "historicoInicio": "2026-05",
  "historicoFim": "2026-09",
  "funcionariosAtual": 6,
  "faixaFuncionariosAtual": "006 A 009",
  "faixaFaturamentoAtual": "ACIMA DE 81K ATE 360K",
  "filiaisAtual": 0,
  "qtdSociosAtual": 2,
  "totalEventos": 9,
  "linhaDoTempo": [
    { "data": "2026-05-04", "tipo": "abertura", "descricao": "Abertura da empresa na Receita Federal" },
    { "data": "2026-05-04", "tipo": "socio", "descricao": "Entrada de Joao Exemplo da Silva (Sócio-Administrador) e Maria Exemplo Souza (Sócio) na sociedade" },
    { "data": "2026-05-04", "tipo": "simples", "descricao": "Opção pelo Simples Nacional" },
    { "data": "2026-05-04", "tipo": "mei", "descricao": "Enquadramento como MEI" },
    { "data": "2026-07", "tipo": "capital", "descricao": "Aumento do capital social de R$ 50.000,00 para R$ 150.000,00", "de": 50000, "para": 150000 },
    { "data": "2026-08", "tipo": "razaoSocial", "descricao": "Razão social alterada de \"EXEMPLO TRANSPORTES LTDA\" para \"EXEMPLO LOGISTICA LTDA\"", "de": "EXEMPLO TRANSPORTES LTDA", "para": "EXEMPLO LOGISTICA LTDA" },
    { "data": "2026-08", "tipo": "cnaeIncluido", "descricao": "Inclusão de atividade secundária: Organizacao logistica do transporte de carga", "cnaes": ["5250804"] },
    { "data": "2026-09-01", "tipo": "situacaoEspecial", "descricao": "Situação especial: Início de Recuperação Judicial" },
    { "data": "2026-09-15", "tipo": "situacao", "descricao": "Situação cadastral passou a Inapta (Omissão de Declarações)" }
  ],
  "historicoNomes": [
    { "data": "2026-05", "razaoSocial": "EXEMPLO TRANSPORTES LTDA", "nomeFantasia": "EXEMPLO LOG" },
    { "data": "2026-08", "razaoSocial": "EXEMPLO LOGISTICA LTDA", "nomeFantasia": "EXEMPLO LOG" }
  ],
  "historicoCapital": [
    { "data": "2026-05", "valor": 50000 },
    { "data": "2026-07", "valor": 150000 }
  ],
  "historicoMensal": [
    { "mes": "2026-05", "capital": 50000, "funcionarios": 3, "filiais": 0, "socios": 2, "faixaFaturamento": "ACIMA DE 81K ATE 360K", "faixaFuncionarios": "001 A 005", "cnaePrincipal": "4930202", "qtdCnaesSecundarios": 1 },
    { "mes": "2026-06", "capital": 50000, "funcionarios": 3, "filiais": 0, "socios": 2, "faixaFaturamento": "ACIMA DE 81K ATE 360K", "faixaFuncionarios": "001 A 005", "cnaePrincipal": "4930202", "qtdCnaesSecundarios": 1 },
    { "mes": "2026-07", "capital": 150000, "funcionarios": 5, "filiais": 0, "socios": 2, "faixaFaturamento": "ACIMA DE 81K ATE 360K", "faixaFuncionarios": "001 A 005", "cnaePrincipal": "4930202", "qtdCnaesSecundarios": 1 },
    { "mes": "2026-08", "capital": 150000, "funcionarios": 5, "filiais": 0, "socios": 2, "faixaFaturamento": "ACIMA DE 81K ATE 360K", "faixaFuncionarios": "001 A 005", "cnaePrincipal": "4930202", "qtdCnaesSecundarios": 2 },
    { "mes": "2026-09", "capital": 150000, "funcionarios": 6, "filiais": 0, "socios": 2, "faixaFaturamento": "ACIMA DE 81K ATE 360K", "faixaFuncionarios": "006 A 009", "cnaePrincipal": "4930202", "qtdCnaesSecundarios": 2 }
  ],
  "avisos": []
}
```

Datas no formato `AAAA-MM-DD` quando o dia é conhecido, `AAAA-MM` para mudanças mensais e `AAAA` para eventos anuais (filiais).

#### Integração por API

Rode o Actor e receba os resultados numa única chamada HTTP:

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~historico-empresa-cnpj-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs": ["81804684000186"]}'
```

Também funciona com os clientes oficiais da Apify para **Python** e **JavaScript/Node.js**, com webhooks e com integrações como **Make, Zapier, n8n e Google Sheets**.

#### Preço

A cobrança é **por empresa retornada**. CNPJs inválidos, repetidos ou que não puderam ser consultados não entram no resultado e não são cobrados. Veja o valor atual na aba **Pricing**.

#### Fontes e atualização

- **Dados cadastrais e sócios:** registros públicos da Receita Federal, consultados no momento da execução.
- **Histórico:** bases de mercado com fotografias mensais do cadastro das empresas.

#### Perguntas frequentes

**Como ver o histórico de alterações de uma empresa pelo CNPJ?**
Informe o CNPJ no campo de entrada e rode o Actor. A linha do tempo mostra, em ordem cronológica, as mudanças de capital social, razão social, nome fantasia, atividades, filiais, faturamento e sócios.

**Dá para saber se a empresa mudou de nome?**
Sim. O campo `historicoNomes` lista todas as razões sociais e nomes fantasia com a data da mudança, e cada troca também aparece na linha do tempo.

**Dá para ver o histórico do capital social?**
Sim. O campo `historicoCapital` traz cada valor de capital social com a data em que passou a valer, e cada aumento ou redução aparece na linha do tempo.

**Quantos CNPJs posso consultar de uma vez?**
Até 50 por execução. Para volumes maiores, faça várias execuções, por exemplo em sequência pela API.

**Serve para empresas MEI, filiais e órgãos públicos?**
Sim. Qualquer CNPJ válido é aceito. O histórico mensal depende de a empresa estar na base de mercado. Quando não está, o registro traz os dados cadastrais e um aviso.

**Os dados são legais de usar?**
São dados de registros públicos e de bases de mercado. O uso deve seguir a LGPD, especialmente para dados de sócios pessoa física.

#### Actors relacionados

Complete a análise da empresa com outros Actors:

| Actor | Para que serve |
|---|---|
| [CNPJ Data Enrichment](https://apify.com/brasildados/brazil-enrich-data-lead-by-cnpj?fpr=t5lwzq) | Enriquecer uma lista de CNPJs com dados cadastrais, contatos e sócios |
| [KYC and PEP by CNPJ](https://apify.com/brasildados/cnpj-kyc-compliance-pep-checker?fpr=t5lwzq) | Verificar compliance, pessoas politicamente expostas (PEP) e sanções |
| [Brazil Government Contracts Check](https://apify.com/brasildados/government-contracts-check?fpr=t5lwzq) | Consultar o histórico de contratos com o Governo Federal |

***

#### English

**Brazil Company History API (CNPJ)**: send a list of Brazilian company tax IDs (CNPJ) and get the company profile plus a **5-year change history**:

- share capital increases and decreases;
- legal name and trade name changes (including "under judicial reorganization" or "in extrajudicial liquidation");
- added and removed business activities (CNAE);
- branch openings and closings;
- revenue bracket changes;
- partner entries.

Each item includes a ready-to-use **timeline** of dated events with `from → to` values, plus monthly snapshots. Built for KYB, compliance, credit risk, supplier onboarding, M\&A due diligence and B2B sales intelligence. Export as JSON, CSV or Excel, or call it via API.

# Actor input Schema

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

Lista de até 50 CNPJs, com ou sem pontuação. CNPJs repetidos ou com dígito verificador inválido são ignorados.

## Actor input object example

```json
{
  "cnpjs": [
    "81.804.684/0001-86",
    "36.503.186/0001-49"
  ]
}
```

# Actor output Schema

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

Dataset com um registro por CNPJ: empresa, endereço, contatos, atividades, sócios e histórico (linha do tempo, nomes, capital e série mensal).

# 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": [
        "81.804.684/0001-86",
        "36.503.186/0001-49"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/historico-empresa-cnpj-api").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": [
        "81.804.684/0001-86",
        "36.503.186/0001-49",
    ] }

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

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "81.804.684/0001-86",
    "36.503.186/0001-49"
  ]
}' |
apify call brasildados/historico-empresa-cnpj-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/historico-empresa-cnpj-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HtQ6RzvgRmOEZl5ID/builds/69c9nLJNbSEfhvYiw/openapi.json
