# API de consulta de CNPJ

> Versão em Markdown de https://datax.plus/api-consulta-cnpj/

Envie um CNPJ e receba, em JSON, os dados cadastrais da empresa: razão social, atividades, porte, Simples e MEI, endereço, contatos e quadro societário. Cada consulta consome 1 requisição do seu limite diário.

[Testar grátis por 24h](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#ficha-cnpj)

● Teste grátis por 24 horas, sem cartão · nos planos Intermediário e Avançado, a partir de R$ 299/mês

```bash
curl https://api.datax.plus/v1/empresas/11222333000181 \
  -H "api-key: $DATAX_KEY"
```

```javascript
const res = await fetch(
  "https://api.datax.plus/v1/empresas/11222333000181",
  { headers: { "api-key": KEY } }
);
const data = await res.json();
```

```python
import requests

r = requests.get(
    "https://api.datax.plus/v1/empresas/11222333000181",
    headers={"api-key": KEY},
)
data = r.json()
```

```json
{
  "cnpj": "11222333000181",
  "razaoSocial": "EXEMPLO TECNOLOGIA LTDA",
  "nomeFantasia": "EXEMPLO TECH",
  "situacaoCadastral": "ATIVA",
  "dataAbertura": "2015-06-02",
  "capitalSocial": 100000.0,
  "atividadePrincipal": {
    "codigo": "6201501",
    "descricao": "Desenvolvimento de programas de computador sob encomenda"
  },
  "simples": { "optante": true, "mei": false },
  "endereco": { "municipio": "SÃO PAULO", "uf": "SP", "cep": "01310100" },
  "contatos": { "email": "contato@...", "telefones": ["1133..."] },
  "socios": [
    { "nome": "JOÃO P. LIMA", "qualificacao": "Sócio-Administrador", "dataEntrada": "2015-06-02" }
  ]
}
```

## Onde a consulta de CNPJ entra

- **Cadastro de clientes e fornecedores**

  Preencha razão social, endereço e atividade a partir do CNPJ, sem digitação.

- **Qualificação de leads B2B**

  Use porte, atividade, capital social e data de abertura para priorizar a lista antes de passar para vendas.

- **Quadro societário**

  Veja quem são os sócios, com qualificação e data de entrada. O telefone e o e-mail de cada um estão na API de sócios.

  [API de sócios →](https://datax.plus/api-socios-cnpj/)

- **CRM e automação**

  Complete a conta assim que o CNPJ entra no sistema, por API ou com n8n, Make e Zapier.

  [Guia de CRM →](https://datax.plus/guias/enriquecer-crm-n8n-make-zapier/)

## Requisição e resposta

A base da DataX traz só empresas ativas. O exemplo é resumido e usa valores fictícios; a resposta pode trazer campos além dos listados.

**GET** `https://api.datax.plus/v1/empresas/{cnpj}`

- **Cabeçalho**: `api-key`: a chave de API gerada no portal. Obrigatório em todas as chamadas.
- **Caminho**: `cnpj`: o CNPJ da empresa, com 14 caracteres, sem pontuação. Aceita o CNPJ numérico e o alfanumérico.
- **Resposta**: JSON (`application/json`) com a ficha da empresa.
- **Consumo**: 1 requisição do limite diário por chamada.
- **MCP**: Agentes de IA usam esta consulta pela ferramenta `ficha_cnpj` do [servidor MCP](https://datax.plus/docs/#mcp).

Por [Equipe DataX](https://datax.plus/) · Atualizada em 4 de novembro de 2026

| Campo | O que traz |
| --- | --- |
| `cnpj`, `cnpjRaiz` | CNPJ consultado e a raiz (8 primeiros caracteres) |
| `razaoSocial`, `nomeFantasia` | Nome empresarial e nome fantasia |
| `situacaoCadastral` | Situação cadastral. A base traz só empresas ativas |
| `dataAbertura` | Data de abertura |
| `matrizFilial` | Se o CNPJ é matriz ou filial |
| `naturezaJuridica`, `porte`, `capitalSocial` | Natureza jurídica, porte e capital social |
| `atividadePrincipal`, `atividadesSecundarias` | Atividades (CNAE), com código e descrição |
| `simples` | Se é optante do Simples Nacional e se é MEI |
| `endereco` | Logradouro, número, complemento, bairro, município, UF e CEP |
| `contatos` | E-mail e telefones da empresa informados no cadastro |
| `socios` | Quadro societário: nome, CPF, qualificação e data de entrada de cada sócio |

[Ver na documentação completa →](https://datax.plus/docs/#ficha-cnpj)

## Planos com a consulta de CNPJ

Cada consulta consome 1 requisição do limite diário. O plano Entrada (R$ 99/mês) é só de pessoa física e não inclui essa consulta. [Ver todos os planos](https://datax.plus/#planos).

| Plano | Preço | Chamadas/dia | Chamadas/min | Custo por chamada |
| --- | --- | --- | --- | --- |
| Teste 24 horas | Grátis | 20 no período | 20 | Grátis |
| Intermediário | R$ 299/mês | 5.000 | 120 | R$ 0,0020 |
| Avançado | R$ 599/mês | 20.000 | 300 | R$ 0,0010 |

O custo por chamada considera o uso de todo o limite diário por 30 dias.

## Perguntas sobre a API de consulta de CNPJ

### Quais dados a consulta de CNPJ retorna?

Razão social, nome fantasia, situação cadastral, data de abertura, matriz ou filial, natureza jurídica, porte, capital social, atividades (CNAE), Simples e MEI, endereço, contatos da empresa informados no cadastro e quadro societário. A resposta vem em JSON.

### Quanto custa consultar um CNPJ por API?

Cada consulta consome 1 requisição do limite diário do plano. Ela está no teste grátis de 24 horas (20 chamadas) e nos planos Intermediário (R$ 299/mês, 5.000 chamadas/dia) e Avançado (R$ 599/mês, 20.000 chamadas/dia). Usando todo o limite diário por 30 dias, cada chamada sai por cerca de R$ 0,0020 e R$ 0,0010, respectivamente.

### A API aceita o CNPJ com letras?

Sim. Desde 31 de julho de 2026, a Receita Federal também emite CNPJ alfanumérico, que convive com o numérico. A API aceita os dois: envie os 14 caracteres sem pontos, barra e traço, com as letras em maiúsculas.

### A consulta traz empresas baixadas ou inaptas?

Não. A base da DataX traz só empresas ativas. Para verificar uma empresa baixada ou inapta, use o cadastro da Receita Federal.

### A ficha do CNPJ traz o telefone dos sócios?

Não. Ela traz o quadro societário e os contatos da empresa informados no cadastro. Para os telefones e e-mails de cada sócio pessoa física, use a [API de sócios](https://datax.plus/api-socios-cnpj/).

### Qual a diferença para a consulta gratuita da Receita Federal?

Na Receita, a consulta é feita uma empresa por vez, à mão, e os dados abertos vêm em arquivos grandes que precisam ser processados. A API entrega os dados cadastrais de um CNPJ numa chamada, em JSON, pronta para o seu sistema.

### Como consultar muitos CNPJs?

Faça uma chamada por CNPJ, respeitando o limite por minuto do plano: 120 chamadas/min no Intermediário e 300 no Avançado. No Avançado, o [lote](https://datax.plus/api-lote-cpf-cnpj/) aceita de 1 a 100 CPFs e CNPJs por pedido, com entrega por webhook.

## Outras consultas da API

- **[API de sócios de um CNPJ](https://datax.plus/api-socios-cnpj/)**

  Telefone e e-mail de cada sócio pessoa física da empresa.

- **[API de consulta em lote](https://datax.plus/api-lote-cpf-cnpj/)**

  De 1 a 100 CPFs e CNPJs num pedido, com entrega por webhook.

- **[API de consulta de CPF](https://datax.plus/api-consulta-cpf/)**

  Dados cadastrais, telefones, e-mails e endereços da pessoa.

[Ver todas as consultas na documentação →](https://datax.plus/docs/)

Guias: [o que é o QSA →](https://datax.plus/guias/qsa-cnpj-quadro-societario-api/) · [API de CNPJ gratuita ou paga →](https://datax.plus/guias/api-cnpj-gratuita-ou-paga/)

## Teste a consulta de CNPJ grátis por 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#ficha-cnpj)