200 OK · base agosto/2026

API de CNPJ com telefones, e-mails e sócios

Cadastro da Receita Federal com telefones, e-mails e sócios quando disponíveis. Por CNPJ, por filtro ou pelo MCP do seu agente, com a data da base em toda resposta.

Entre com GitHub, Google ou e-mail. A chave aparece na hora. Sem fidelidade.

api.cnpj.ia.br
$ 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",
    "contatos_extras": [{ "tipo": "telefone", "valor": "(21) 3808-2020", "origem": "oportunidados" }],
    "faixa_faturamento": {
      "faixa": "Superior a R$4.800.000,00", "origem": "porte"
    },
    "regime_tributario": { "regime": "Lucro Real" },
    "socios": [{
      "qualificacao": { "descricao": "Diretor" },
      "cnpj_cpf_socio": "***345856**"
    }]
  },
  "meta": { "data_as_of": "2026-08-10", "credits_charged": 6 }
}

200 OK · resposta real capturada da API · base agosto/2026

No Pro (R$ 199/mês): R$ 0,0119 a consulta full, R$ 0,0020 a basic. Erro, 404 e limite custam 0.

Números da base e do produto

71.874.499

CNPJs registrados na Receita Federal

28.092.896

empresas com situação ativa

0

créditos por erro, 404 ou limite: só resposta 200 é cobrada

2.000+

empresas clientes da Oportunidados, desde 2020

Contagem da Radiografia dos CNPJs de junho/2026. A API responde com a base mensal mais recente, hoje a de agosto/2026.

Uma assinatura, três jeitos de usar

API de CNPJ no seu produto, na sua automação e no seu agente

A mesma chave, os mesmos créditos e o mesmo JSON no seu backend, no seu fluxo de automação e no seu agente.

Valide e preencha o cadastro de PJ

No onboarding, o CNPJ digitado vira razão social, situação cadastral, endereço e CNAE antes do usuário terminar o formulário. No CRM, a conta ganha telefones, e-mail, site e sócios quando disponíveis.

  • Perfil basic para validar; full para enriquecer
  • Aceita o CNPJ alfanumérico
seu backend
const r = await fetch(
  `https://api.cnpj.ia.br/v1/cnpjs/${cnpj}?profile=basic`,
  { headers: { Authorization: `Bearer ${process.env.CNPJIA_KEY}` } }
);
const { data, meta } = await r.json();

data.situacao_cadastral.descricao  // "Ativa"
data.endereco.municipio            // "Brasília"
meta.data_as_of                    // "2026-08-10"
meta.credits_charged               // 1

Enriqueça o lead que entrou no funil

Um nó HTTP Request no n8n, no Make ou no Zapier. JSON sempre no mesmo formato, erros com código estável e Retry-After no 429.

  • Busca paginada por cursor, para listas inteiras
  • PIX ou cartão, com NFS-e
n8n · HTTP Request
{
  "node": "HTTP Request",
  "method": "GET",
  "url": "https://api.cnpj.ia.br/v1/cnpjs/{{ $json.cnpj }}",
  "queryParameters": { "profile": "full" },
  "headerAuth": { "Authorization": "Bearer <credencial>" }
}

Dê ao agente a base de empresas do Brasil

Uma linha no Claude Code, no Cursor ou no Windsurf. O agente consulta, busca, gera o filtro a partir de uma frase e confere o uso, com a sua chave e os seus créditos.

  • Mesma chave e mesmos créditos da API
  • O agente não compra créditos nem muda de plano
claude code
$ claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br \
    --header "Authorization: Bearer $CNPJIA_KEY"

> Qual é a situação cadastral e o CNAE principal do CNPJ 00.000.000/0001-91?

  cnpjia.consultar_cnpj → 200 OK · 1 crédito
  Ativa · Bancos múltiplos, com carteira comercial

Preços da API de CNPJ: o custo antes de cada chamada

1 crédito por consulta basic, 6 pela full, 1 por empresa na busca. Só respostas 200 são cobradas; quando a franquia acaba, a API para.

Free

Grátis todo mês, sem prazo

R$ 0 /mês

60 créditos por mês

15 na hora, o resto com e-mail verificado

  • 10 consultas full
  • 3 req/min
  • Busca de empresas: não
  • MCP
Criar chave grátis

Starter

Para onboarding e automações

R$ 49 /mês

15 mil créditos por mês

  • 2,5 mil consultas full
  • 30 req/min
  • Busca de empresas
  • MCP

R$ 0,0196 por consulta full

Escolher Starter
Recomendado

Pro

Para enriquecer CRM todo mês

R$ 199 /mês

100 mil créditos por mês

  • ≈ 16,7 mil consultas full
  • 120 req/min
  • Busca de empresas
  • MCP

R$ 0,0119 por consulta full

Escolher Pro

Business

Para produto com volume

R$ 699 /mês

500 mil créditos por mês

  • ≈ 83,3 mil consultas full
  • 300 req/min
  • Busca de empresas
  • MCP

R$ 0,0084 por consulta full

Escolher Business

Sem surpresa na fatura

Acabou a franquia, a API para

Quando os créditos do mês acabam, a API responde 402 e nada é cobrado sem uma ação sua: não existe excedente nem recarga automática. Precisa de mais antes da virada? Troque de plano ou compre um pacote avulso.

Acima do Business: Scale, 3 mi créditos por R$ 1.999/mês. Pacotes avulsos e calculadora em preços da API de CNPJ.

O que a consulta de CNPJ retorna, no basic e no full

basic, 1 crédito: o cadastro. full, 6 créditos: o cadastro mais contatos, sócios, regime tributário e as faixas. Tipo e nulabilidade de cada campo em campos da resposta.

GET /v1/cnpjs/00000000000191?profile=full
"razao_social": "BANCO DO BRASIL SA",
"situacao_cadastral": { "descricao": "Ativa" },
"cnae_fiscal": { "codigo": "6422100" },
"endereco": { "municipio": "Brasília", "uf": "DF" }

Cadastro basic e full

Razão social, situação cadastral e a data dela, natureza jurídica, porte, capital social, CNAE principal e secundários, endereço com código IBGE, Simples e MEI.

"has_phone": true, "has_email": true,
"telefones": [{ "ddd": "61", "numero": "34939002" }],
"email": "secex@bb.com.br"

Contato só no full

Telefones, e-mail e site quando disponíveis. No basic, os sinais has_phone, has_email e has_website dizem se vale pedir o full.

"regime_tributario": { "regime": "Lucro Real" },
"faixa_faturamento": { "origem": "porte" }

Fiscal e faixas só no full

Regime tributário, faixa de faturamento (derivada do porte) e faixa de funcionários.

"socios": [{ "qualificacao": { "descricao": "Diretor" } }]

Sócios só no full

Quadro societário com qualificação do sócio e representante legal, CPF mascarado ou nulo, nunca completo.

"meta": { "data_as_of": "2026-08-10", "credits_charged": 6 }

Data e custo basic e full

meta.data_as_of diz qual foto mensal da Receita respondeu; meta.credits_charged, quanto a chamada custou.

Busca de empresas por UF, município, CNAE e porte

Filtre também por situação, Simples, MEI, natureza jurídica, capital, abertura, nome, sócio, faturamento e raio. A busca começa no Starter (R$ 49/mês); no Free, só a consulta por CNPJ.

Padarias ativas em Curitiba, no Simples

GET /v1/cnpjs?

  • uf=PRParaná
  • municipio=4106902Curitiba (IBGE)
  • cnae=1091102padaria
  • situacao=ATIVAsó ativas
  • simples=trueoptantes do Simples

20empresas por página

1crédito por empresa

0se a página vier vazia

Cada empresa da página já vem com has_phone e has_email: pague o full só das que têm contato. No MCP, gerar_filtro monta o filtro a partir da frase. Todos os parâmetros na documentação da busca de empresas.

Empresas ativas por UF · Radiografia de junho/2026

  • RR 53,6 mil
  • AP 48,7 mil
  • AM 282,0 mil
  • PA 536,2 mil
  • MA 374,8 mil
  • CE 732,4 mil
  • RN 316,0 mil
  • AC 52,6 mil
  • RO 174,6 mil
  • TO 175,3 mil
  • PI 241,3 mil
  • PE 753,2 mil
  • PB 358,3 mil
  • MT 557,7 mil
  • GO 1,0 mi
  • BA 1,2 mi
  • SE 174,1 mil
  • AL 241,2 mil
  • MS 376,5 mil
  • DF 466,6 mil
  • MG 2,9 mi
  • ES 592,4 mil
  • PR 2,0 mi
  • SP 8,7 mi
  • RJ 2,3 mi
  • SC 1,5 mi
  • RS 1,8 mi

Quantas empresas existem no Brasil, por UF, porte e situação

MCP oficial de CNPJ para Claude, Cursor e agentes OpenAI

O servidor em mcp.cnpj.ia.br usa a mesma chave e os mesmos créditos da API. Quatro ferramentas: consultar, buscar, gerar filtro e ver uso.

você

Qual é a situação cadastral e o CNAE principal do CNPJ 00.000.000/0001-91?

ferramenta

consultar_cnpj({ "cnpj": "00000000000191", "profile": "basic" })

200 OK · 1 crédito

agente

BANCO DO BRASIL SA está com situação ativa. CNAE principal: bancos múltiplos, com carteira comercial. Dado da base de agosto/2026.

Claude Code
$ claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br \
  --header "Authorization: Bearer $CNPJIA_KEY"

Cursor, Windsurf, Claude Desktop e agentes OpenAI: configuração do MCP em cada cliente.

Outras perguntas que o agente passa a responder

  • “Liste padarias ativas em Curitiba optantes do Simples e me diga quantas são.” busca, a partir do Starter
  • “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.

Perguntas frequentes sobre a API de CNPJ

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 com CPF mascarado, 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.

O que acontece quando os créditos do mês acabam?

A API responde 402 com o código quota_exceeded e para. Nada é cobrado sem uma ação sua: não existe excedente nem recarga automática. Para seguir antes da virada do mês, troque de plano ou, num plano pago, compre um pacote avulso. A franquia renova no primeiro dia do mês e não acumula.

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 devolve o CPF de sócio só mascarado, nunca completo, e honra pedidos de remoção de contatos; a matriz completa está em /docs/privacidade-e-uso-aceitavel.

200 OK · base agosto/2026

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.