API de CNPJ com telefones, e-mails e sócios
Empresas da base da Receita Federal, enriquecidas pela Oportunidados. Consulte por CNPJ, busque por filtros e conecte seu agente por MCP, com a data da base em toda resposta de consulta e busca.
15 créditos na hora, 60 por mês com e-mail verificado. Cancele quando quiser.
$ curl "https://api.cnpj.ia.br/v1/cnpjs/00000000000191?profile=full" \ -H "Authorization: Bearer $CNPJIA_KEY"{ "data": { "razao_social": "BANCO DO BRASIL SA", "situacao_cadastral": { "descricao": "Ativa" }, "cnae_fiscal": { "descricao": "Bancos múltiplos, com carteira comercial" }, "telefones": [{ "ddd": "61", "numero": "34939002" }], "email": "secex@bb.com.br", "faixa_faturamento": { "faixa": "Superior a R$4.800.000,00", "origem": "porte" }, "regime_tributario": { "regime": "Lucro Real" }, "socios": [{ "qualificacao": { "descricao": "Diretor" } }] }, "meta": { "data_as_of": "2026-08-01", "credits_charged": 6 } }
Trecho da resposta capturada da API para BANCO DO BRASIL SA (00.000.000/0001-91), com campos selecionados, no formato do contrato. Base da Receita Federal de agosto/2026.
Três verbos, dois endpoints
Cada operação tem um custo declarado em créditos. Erros, 404 e limites custam 0.
GET /v1/cnpjs/{cnpj} · 1 ou 6 créditos
Cadastro completo de um CNPJ conhecido: situação, endereço, CNAE, Simples e MEI, com a data da base em cada resposta; contatos e sócios no perfil full.
GET /v1/cnpjs?uf=&cnae= · 1 crédito por empresa
Empresas por UF, município, CNAE, porte, situação, Simples, MEI, natureza jurídica, capital e data de abertura. Páginas por cursor. Nos planos pagos.
profile=full · dentro dos 6 créditos
Telefones, e-mail, site e quadro societário quando disponíveis, dentro do perfil full. Nunca CPF.
Para agentes: MCP oficial
O servidor em mcp.cnpj.ia.br usa a mesma chave e os mesmos créditos da API. Quatro ferramentas: consultar, buscar (nos planos pagos), gerar filtro e ver uso.
Claude Code
claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br \
--header "Authorization: Bearer $CNPJIA_KEY"
Cursor
{
"mcpServers": {
"cnpjia": {
"url": "https://mcp.cnpj.ia.br",
"headers": { "Authorization": "Bearer cnpj_live_..." }
}
}
}
O que um agente passa a responder
- “Qual é a situação cadastral e o CNAE principal do CNPJ 00.000.000/0001-91?”
- “Liste padarias ativas em Curitiba optantes do Simples e me diga quantas são.”
- “Quantos créditos ainda tenho este mês?”
A chave fica no cliente do agente. O agente consulta e busca; não compra créditos nem muda de plano.
Como funciona
-
Crie a chave
E-mail e senha, ou GitHub e Google. A chave aparece uma vez e já funciona.
Authorization: Bearer cnpj_live_… -
Faça a primeira chamada
Um curl e o JSON volta com a data da base e o custo em créditos. Erros não consomem créditos.
curl https://api.cnpj.ia.br/v1/cnpjs/00000000000191?profile=full \ -H "Authorization: Bearer $CNPJIA_KEY" -
Assine quando precisar de mais
Cinco planos por crédito, sem fidelidade. Cartão ou PIX, nota fiscal em toda cobrança.
GET /v1/usage
Preços por crédito
Você sabe o custo antes de chamar: basic 1, full 6, busca 1 por empresa retornada, gerar filtro 1. Só respostas 200 são cobradas.
R$ 0,0119 por empresa com contato no Pro Ver preços, pacotes e calculadora →
O que vem em cada resposta
O perfil basic é o cadastro; o full acrescenta contatos, sócios, regime tributário e as faixas de faturamento e de funcionários. Todos os campos, com tipo e nulabilidade, em Campos da resposta.
| basic | full | |
|---|---|---|
| Identificação, situação cadastral, natureza jurídica, porte, capital | ✓ | ✓ |
| CNAE principal e secundários, endereço com códigos IBGE e SIAFI | ✓ | ✓ |
| Simples, MEI e os sinais has_phone, has_email, has_website | ✓ | ✓ |
| Telefones, e-mail e site | — | ✓ |
| Sócios e representante legal (sem CPF) | — | ✓ |
| Regime tributário | — | ✓ |
| Faixa de faturamento (derivada do porte) e faixa de funcionários | — | ✓ |
Campos por perfil conforme openapi/openapi.json e _data/campos.yml. Créditos de _data/pricing.yml.
Frescor
Base mensal, com a data em toda resposta de consulta e busca
A base é a foto mensal dos dados abertos da Receita Federal. meta.data_as_of diz qual foto respondeu; GET /v1/status informa a data sem chave. Durante a carga mensal a API responde 503 com Retry-After, e a janela é anunciada na status page.
Privacidade
CPF nunca sai. Pedidos de remoção valem para a API
Quando presente no full, o quadro societário vem sem CPF; a API também nunca retorna CPF na busca nem no MCP. Empresa com pedido de remoção de contatos responde com meta.suppressed: true, sem telefones, e-mail, site e sócios, e a chamada custa o preço do basic.
Perguntas frequentes
O que é o cnpj.ia.br?
Uma API REST e um servidor MCP para consultar e buscar empresas brasileiras por CNPJ: dados cadastrais da Receita Federal, telefones, e-mails, sócios sem CPF, regime tributário e faixa de faturamento derivada do porte. É um produto da Oportunidados, empresa de dados B2B de Curitiba em operação desde 2020.
Os dados refletem o instante da consulta?
Não. A base é a da Receita Federal, atualizada mensalmente e enriquecida pela Oportunidados. Toda resposta de consulta e de busca informa a data da base em meta.data_as_of, e GET /v1/status diz a data atual sem chave.
Vem telefone e e-mail?
Sim, no perfil full, quando constam na base. O perfil basic traz o cadastro e os sinais has_phone, has_email e has_website, que dizem se vale pedir o full para aquela empresa.
Quanto custa?
Tudo é cobrado em créditos, com peso fixo por operação: uma consulta basic pesa menos que uma full, e cada empresa retornada na busca pesa como um basic. Há um plano gratuito mensal e quatro planos pagos, sem fidelidade; a tabela, os pacotes avulsos e a calculadora estão em /precos. Só respostas 200 são cobradas.
Funciona com Claude, Cursor e outros agentes?
Sim. O servidor MCP em mcp.cnpj.ia.br usa a mesma chave da API e expõe consulta, busca (nos planos pagos), geração de filtro e leitura de uso como ferramentas. Claude Code, Cursor e Windsurf conectam direto; Claude Desktop pela ponte mcp-remote; agentes OpenAI pela ferramenta mcp da Responses API.
Posso usar os contatos para prospecção B2B?
Para abordagem comercial a empresas, com contato do estabelecimento e respeito às regras do canal, sim. Mensagens em massa não solicitadas, revenda da base e tentativa de identificar pessoas físicas, não. A API nunca retorna CPF e honra pedidos de remoção de contatos; a matriz completa está em /docs/privacidade-e-uso-aceitavel.
Crie sua chave. O primeiro 200 leva menos de cinco minutos.
15 créditos na hora, 60 por mês com e-mail verificado. Sem fidelidade.