---
title: "GET /v1/cnpjs/{cnpj}"
description: "Consultar um CNPJ"
canonical: "https://cnpj.ia.br/docs/referencia/get-cnpj"
date_modified: 2026-09-02
source: "cnpj.ia.br"
---

docs · base agosto/2026 Atualizado em 02/09/2026

# GET /v1/cnpjs/{cnpj}

Consultar um CNPJ

Retorna o perfil `basic` (1 crédito) ou `full` (6 créditos) de uma empresa. Aceita CNPJ numérico ou alfanumérico, com ou sem pontuação.

## Créditos

perfil basic · **1** crédito perfil full · **6** créditos

## Parâmetros

| Nome | Em | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- | --- |
| `cnpj` | path | `string` | Sim | CNPJ numérico ou alfanumérico, com ou sem pontuação. |
| `profile` | query | `string` enum: `basic`, `full` valor padrão: `basic` | — | `basic`: cadastro. `full`: cadastro + telefones, e-mails, site, sócios (sem CPF), regime tributário, faixa de funcionários e faixa de faturamento. |

## Respostas

### 200 OK

Empresa encontrada. Se houver pedido de remoção ativo, `meta.suppressed` é `true`, os campos de contato e sócios são omitidos e a cobrança é de 1 crédito.

| Header | Tipo | Descrição |
| --- | --- | --- |
| `X-Request-Id` | `string` | Identificador da requisição para suporte. |
| `X-Credits-Charged` | `integer` | Créditos debitados nesta resposta. |
| `X-Credits-Remaining` | `integer` | Créditos restantes (franquia + pacotes). |
| `X-Credits-Reset` | `string` formato: `date-time` | Instante do próximo reset da franquia (RFC 3339). |
| `X-RateLimit-Limit` | `integer` | Requisições por minuto do plano (por conta). |
| `X-RateLimit-Remaining` | `integer` | Requisições restantes no minuto corrente. |

```json
{
  "data": {
    "cnpj": "00000000000191",
    "raiz_cnpj": "00000000",
    "razao_social": "BANCO DO BRASIL SA",
    "nome_fantasia": "DIRECAO GERAL",
    "matriz_filial": {
      "codigo": "1",
      "descricao": "Matriz"
    },
    "n_filiais": 4000,
    "data_inicio_atividade": "1966-08-01",
    "situacao_cadastral": {
      "codigo": "02",
      "descricao": "Ativa"
    },
    "data_situacao_cadastral": "2005-11-03",
    "motivo_situacao_cadastral": {
      "codigo": "00",
      "descricao": "Sem motivo"
    },
    "situacao_especial": null,
    "data_situacao_especial": null,
    "natureza_juridica": {
      "codigo": "2038",
      "descricao": "Sociedade de Economia Mista"
    },
    "porte": {
      "codigo": "05",
      "descricao": "Demais"
    },
    "capital_social": 120000000000,
    "cnae_fiscal": {
      "codigo": "6422100",
      "descricao": "Bancos múltiplos, com carteira comercial"
    },
    "cnaes_secundarios": [],
    "endereco": {
      "tipo_logradouro": "Quadra",
      "logradouro": "SAUN QUADRA 5 LOTE B",
      "numero": "S/N",
      "complemento": "TORRES I, II E III",
      "bairro": "ASA NORTE",
      "cep": "70040912",
      "municipio": "Brasília",
      "codigo_municipio_ibge": "5300108",
      "codigo_municipio_siafi": "9701",
      "uf": "DF"
    },
    "simples": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "mei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "has_email": true,
    "has_website": true,
    "has_phone": true,
    "has_mobile_phone": false,
    "telefones": [
      {
        "ddd": "61",
        "numero": "34939002"
      }
    ],
    "email": "exemplo@bb.com.br",
    "site": "https://www.bb.com.br",
    "contatos_extras": [],
    "socios": [
      {
        "nome": "NOME DO DIRIGENTE",
        "tipo": {
          "codigo": "2",
          "descricao": "Pessoa Física"
        },
        "qualificacao": {
          "codigo": "10",
          "descricao": "Diretor"
        },
        "data_entrada": "2025-01-01",
        "pais": {
          "codigo": "105",
          "descricao": "Brasil"
        },
        "faixa_etaria": {
          "codigo": "6",
          "descricao": "51 a 60 anos"
        },
        "representante": null
      }
    ],
    "faixa_faturamento": {
      "faixa": "Superior a R$4.800.000,00",
      "origem": "porte"
    },
    "faixa_funcionarios": null,
    "regime_tributario": {
      "regime": "Lucro Real",
      "ano": 2025,
      "escrituracoes": [
        "ECD",
        "ECF"
      ]
    }
  },
  "meta": {
    "request_id": "req_01J8ZK3Q9X",
    "profile": "full",
    "source": "rfb_open_data+oportunidados",
    "data_as_of": "2026-08-01",
    "suppressed": false,
    "credits_charged": 6,
    "credits_remaining": 99994,
    "credits_reset_at": "2026-10-01T00:00:00-03:00"
  }
}
```

### 400 Requisição inválida

CNPJ inválido (formato ou dígito).

### 401 Não autorizado

Chave ausente, desconhecida, revogada ou expirada.

### 402 Pagamento necessário

Franquia e pacotes esgotados. Header X-Credits-Reset.

### 403 Proibido

`insufficient_plan` (operação fora do plano) ou `payment_required` (cobrança recusada há mais de 7 dias).

### 404 Não encontrado

CNPJ válido ausente na base, ou removido a pedido do titular.

### 429 Excesso de requisições

Requisições por minuto da conta excedidas. Header Retry-After.

| Header | Tipo | Descrição |
| --- | --- | --- |
| `Retry-After` | `integer` | Só em 429 e 503: segundos até tentar de novo. |

### 503 Serviço indisponível

Janela mensal de atualização da base. Header Retry-After.

### 504 Tempo esgotado

Timeout de consulta. `retryable: true`; nada é cobrado.

## Ferramenta MCP

No servidor MCP oficial esta operação é a ferramenta `consultar_cnpj`, com a mesma chave e os mesmos créditos da API.

## Exemplo

```bash
curl -s "https://api.cnpj.ia.br/v1/cnpjs/00000000000191" \
  -H "Authorization: Bearer $CNPJIA_KEY"
```