--- title: "API de CNPJ com telefones, e-mails e sócios" canonical: "https://cnpj.ia.br" date_modified: 2026-09-03 source: "cnpj.ia.br" --- 200 OK · base agosto/2026 # 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. [Criar chave grátis](https://app.cnpj.ia.br/signup) [Ver o MCP](https://cnpj.ia.br/docs/mcp) 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. Base da Receita Federal de agosto/2026 Por Oportunidados, desde 2020 · **2.000+** empresas clientes Pagamento por cartão e PIX · NFS-e ## Três verbos, dois endpoints Cada operação tem um custo declarado em créditos. Erros, 404 e limites custam 0. [Consultar`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.](https://cnpj.ia.br/docs/consulta-cnpj) [Buscar`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.](https://cnpj.ia.br/docs/busca-empresas) [Contatar`profile=full · dentro dos 6 créditos` Telefones, e-mail, site e quadro societário quando disponíveis, dentro do perfil full. Nunca CPF.](https://cnpj.ia.br/docs/campos) ## 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 ```bash claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br \ --header "Authorization: Bearer $CNPJIA_KEY" ``` #### Cursor ```json { "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. [Configurar Claude, Cursor, Windsurf e OpenAI →](https://cnpj.ia.br/docs/mcp) ## Como funciona 1. Crie a chave E-mail e senha, ou GitHub e Google. A chave aparece uma vez e já funciona. ``` Authorization: Bearer cnpj_live_… ``` 2. 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" ``` 3. 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 →](https://cnpj.ia.br/precos) ## 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](https://cnpj.ia.br/docs/campos). | | 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. [Dados e frescor →](https://cnpj.ia.br/docs/dados-e-frescor) 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`. [Privacidade e uso aceitável →](https://cnpj.ia.br/docs/privacidade-e-uso-aceitavel) ## 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. [Criar chave grátis](https://app.cnpj.ia.br/signup) [Ler o início rápido](https://cnpj.ia.br/docs/inicio-rapido)