# API de CNPJ

> Consulte o cadastro de qualquer CNPJ do Brasil: situação, endereço, CNAE, Simples e contato.

Base: `https://cnpj.apizen.com.br/v1`. Dados abertos da Receita Federal, de novembro de 2026 (74.373.417 estabelecimentos), atualizados todo mês.

## O CNPJ no caminho

- 14 caracteres. Pontos, barra e hífen são aceitos (a barra codificada como `%2F`, ou omitida).
- **CNPJ alfanumérico**: desde julho de 2026 os CNPJs novos podem ter letras nos 12 primeiros caracteres; os dois últimos (dígitos verificadores) são sempre números. Maiúsculas e minúsculas são iguais.

## GET /cnpj/{cnpj}

O cadastro de um estabelecimento (matriz ou filial).

**cURL**

```bash
curl https://cnpj.apizen.com.br/v1/cnpj/33000167000101 \
  -H "Authorization: Bearer $CNPJ_API_KEY"
```

**JavaScript**

```javascript
const res = await fetch("https://cnpj.apizen.com.br/v1/cnpj/33000167000101", {
  headers: { Authorization: `Bearer ${process.env.CNPJ_API_KEY}` },
});
const dados = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://cnpj.apizen.com.br/v1/cnpj/33000167000101",
    headers={"Authorization": f"Bearer {os.environ['CNPJ_API_KEY']}"},
)
dados = res.json()
```

**Go**

```go
req, _ := http.NewRequest("GET", "https://cnpj.apizen.com.br/v1/cnpj/33000167000101", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("CNPJ_API_KEY"))
res, err := http.DefaultClient.Do(req)
```

```json
{
  "cnpj": "33000167000101",
  "razao_social": "Petroleo Brasileiro S A Petrobras",
  "nome_fantasia": "Petrobras - Edise",
  "matriz": true,
  "ativa": true,
  "situacao": { "codigo": "02", "descricao": "Ativa" },
  "data_situacao": "2005-11-03",
  "data_inicio_atividade": "1966-09-28",
  "simples": null,
  "mei": null,
  "cnae": { "codigo": "0600001", "descricao": "Extração de petróleo e gás natural" },
  "endereco": {
    "logradouro": "Avenida Republica do Chile",
    "numero": "65",
    "complemento": null,
    "bairro": "Centro",
    "cep": "20031170",
    "municipio": { "codigo_ibge": "3304557", "nome": "Rio de Janeiro" },
    "uf": "RJ"
  },
  "telefone": "2121660000",
  "email": "cc-rfisc@petrobras.com.br"
}
```

| Campo | Tipo | |
|---|---|---|
| `cnpj` | texto | os 14 caracteres, sem pontuação |
| `razao_social` | texto | nome empresarial |
| `nome_fantasia` | texto ou null | |
| `matriz` | booleano | `true` na matriz, `false` numa filial |
| `ativa` | booleano | situação cadastral ativa |
| `situacao` | objeto | `codigo` e `descricao`: 01 Nula, 02 Ativa, 03 Suspensa, 04 Inapta, 08 Baixada |
| `data_situacao` | data ou null | AAAA-MM-DD |
| `data_inicio_atividade` | data ou null | AAAA-MM-DD |
| `simples` | booleano ou null | optante do Simples Nacional; null quando não há registro |
| `mei` | booleano ou null | microempreendedor individual |
| `cnae` | objeto ou null | atividade principal: `codigo` (7 dígitos) e `descricao` |
| `endereco` | objeto | `logradouro`, `numero`, `complemento`, `bairro`, `cep` (8 dígitos), `municipio` (`codigo_ibge`, `nome`), `uf` |
| `telefone` | texto ou null | DDD e número, só dígitos |
| `email` | texto ou null | como declarado à Receita |

## GET /cnpj/{cnpj}/nome

Só a razão social e o nome fantasia. Mais leve: bom para validar um CNPJ num formulário.

```json
{
  "cnpj": "33000167000101",
  "razao_social": "Petroleo Brasileiro S A Petrobras",
  "nome_fantasia": "Petrobras - Edise"
}
```

## GET /base

O mês dos dados e quantos estabelecimentos há.

```json
{
  "mes": "2026-11",
  "estabelecimentos": 74373417
}
```
