> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /cnpj-data/:cnpj

> Consulte qualquer empresa brasileira pelo CNPJ. Retorna razão social, status, atividade, endereço e data de abertura em uma única requisição.

## Endpoint

```
GET https://api.bunny.build/api/v1/cnpj-data/:cnpj
```

## Autenticação

| Header      | Obrigatório | Valor                        |
| ----------- | ----------- | ---------------------------- |
| `X-API-Key` | Sim         | Sua chave de API (`bun_...`) |

## Visão geral

Consulte qualquer empresa brasileira registrada pelo CNPJ. A Bunny retorna razão social, nome fantasia, situação cadastral, data de abertura, natureza jurídica, atividade principal, endereço e capital: tudo o que você precisa para verificar um parceiro comercial ou pré-preencher formulários B2B.

## Casos de uso

* Verificação KYC e onboarding em plataformas B2B
* Pré-preenchimento de formulários de cadastro de empresas
* Validação de CNPJs de fornecedores e parceiros
* Verificações de compliance e due diligence

## Detalhes

Passe o CNPJ com ou sem formatação. Pontos, barras e hífens são removidos automaticamente. CNPJs inativos ou suspensos também são retornados com a situação cadastral indicada.

## Parâmetros de rota

| Parâmetro | Tipo   | Obrigatório | Descrição                                                |
| --------- | ------ | ----------- | -------------------------------------------------------- |
| `cnpj`    | string | Sim         | CNPJ da empresa, somente dígitos (ex.: `11222333000181`) |

## Resposta

### 200 OK

| Campo        | Tipo           | Descrição                                  |
| ------------ | -------------- | ------------------------------------------ |
| `cnpj`       | string         | O CNPJ consultado                          |
| `name`       | string \| null | Razão social                               |
| `trade_name` | string \| null | Nome fantasia                              |
| `status`     | string \| null | Situação cadastral (ex.: `ATIVA`)          |
| `type`       | string \| null | Natureza jurídica                          |
| `opened_at`  | string \| null | Data de abertura (ISO 8601)                |
| `activity`   | string \| null | Descrição da atividade principal           |
| `address`    | object \| null | Endereço (logradouro, cidade, estado, CEP) |

**Exemplo**

```json theme={null}
{
  "cnpj": "11222333000181",
  "name": "EMPRESA EXEMPLO LTDA",
  "trade_name": "Empresa Exemplo",
  "status": "ATIVA",
  "type": "LTDA",
  "opened_at": "2010-05-20",
  "activity": "Desenvolvimento de software",
  "address": {
    "street": "Rua das Flores, 100",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01310100"
  }
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 404 Not Found

CNPJ não encontrado.

```json theme={null}
{
  "detail": "CNPJ not found"
}
```

### 422 Unprocessable Entity

Formato de CNPJ inválido.

```json theme={null}
{
  "detail": "Invalid CNPJ format"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
curl https://api.bunny.build/api/v1/cnpj-data/11222333000181 \
  -H "X-API-Key: bun_sua_chave_api"
```