GET /v1/cnpjs/{cnpj} · cnpj.ia.br

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.

{
  "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

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