# cnpj.ia.br

> API e servidor MCP para consultar e buscar empresas brasileiras por CNPJ: dados cadastrais da Receita Federal, contatos (telefones, e-mails, site), quadro societário sem CPF, regime tributário, faixa de funcionários e faixa de faturamento (derivada do porte). Base mensal com data declarada em toda resposta. A base de empresas do Brasil, pronta para o seu agente. Produto da Oportunidados.

Mantido pela Oportunidados (Atmosphere Tecnologia de Dados LTDA, CNPJ 51.300.019/0001-94), Curitiba/PR, Brasil, em operação desde 2020. Idioma: português (Brasil). Cobertura: 70 milhões de CNPJs registrados na Receita Federal, 28 milhões com situação ativa (base de agosto/2026). Estado: pré-lançamento (site em construção; a API e o MCP ainda não estão públicos).

## Começar
- [Início rápido](https://cnpj.ia.br/docs/inicio-rapido.md): primeira consulta em 5 minutos, com curl, Python e Node.
- [Autenticação](https://cnpj.ia.br/docs/autenticacao.md): header Authorization: Bearer, escopo da chave por conta e o que a API responde quando a chave é recusada.
- [Criar chave](https://app.cnpj.ia.br/signup): 60 créditos grátis por mês (10 consultas full).
- [OpenAPI 3.1](https://cnpj.ia.br/openapi/openapi.json): contrato da API (rascunho; canônico será https://api.cnpj.ia.br/openapi.json).
- [MCP](https://cnpj.ia.br/docs/mcp.md): servidor em https://mcp.cnpj.ia.br, mesma chave da API.

## Referência
- [Referência da API](https://cnpj.ia.br/docs/referencia): referência gerada do OpenAPI, uma página por operação, com parâmetros, respostas, headers, créditos e ferramenta MCP.
- [Consulta por CNPJ](https://cnpj.ia.br/docs/consulta-cnpj.md): GET /v1/cnpjs/{cnpj}?profile=basic|full. basic = 1 crédito, full = 6.
- [Busca de empresas](https://cnpj.ia.br/docs/busca-empresas.md): GET /v1/cnpjs com filtros por CNAE, UF, município, porte, situação, Simples/MEI, natureza jurídica, capital e abertura. Até 20 por página, cursor, 1 crédito por empresa retornada.
- [Campos](https://cnpj.ia.br/docs/campos.md): todos os campos, tipos, enums e nulabilidade.
- [Créditos e limites](https://cnpj.ia.br/docs/creditos-e-limites.md): pesos, franquia, rpm por conta, hard cap, pacotes, GET /v1/usage.
- [Erros e retentativas](https://cnpj.ia.br/docs/erros-e-retentativas.md): envelope de erro, códigos estáveis, Retry-After, janela de manutenção mensal.
- [CNPJ alfanumérico](https://cnpj.ia.br/docs/cnpj-alfanumerico.md)
- [Dados e frescor](https://cnpj.ia.br/docs/dados-e-frescor.md): fonte, licença, ciclo mensal, o que é derivado, método de contagem.
- [Privacidade e uso aceitável](https://cnpj.ia.br/docs/privacidade-e-uso-aceitavel.md): o que sai, o que não sai, supressão, o que pode ser feito com os contatos.
- [Versionamento](https://cnpj.ia.br/docs/versionamento.md): o que é estável no contrato /v1 e como uma mudança incompatível é anunciada.

## Preços
- [Preços](https://cnpj.ia.br/precos): Free 60 créditos/mês; Starter R$ 49 (15 mil); Pro R$ 199 (100 mil); Business R$ 699 (500 mil); Scale R$ 1.999 (3 milhões). Pacotes de R$ 50 (8 mil), R$ 200 (35 mil) e R$ 500 (100 mil), válidos 12 meses. Cartão ou PIX. Sem fidelidade.
- [Preços (estruturado)](https://cnpj.ia.br/pricing.md)

## Para quem
- [API de CNPJ para agentes](https://cnpj.ia.br/api-cnpj-para-agentes.md): servidor MCP oficial com consultar, buscar, gerar filtro e ver uso; a chave fica no cliente do agente.
- [API de CNPJ para automação](https://cnpj.ia.br/api-cnpj-para-automacao.md): n8n, Make e Zapier pelo nó HTTP Request; erros com código estável e `retryable`.
- [API de CNPJ para enriquecer CRM](https://cnpj.ia.br/api-cnpj-para-crm.md): basic para todas as contas, full só onde há contato; faixa de faturamento derivada do porte.
- [API de CNPJ para onboarding de PJ](https://cnpj.ia.br/api-cnpj-para-onboarding.md): situação cadastral e sua data, matriz ou filial, CNPJ alfanumérico; erros não consomem crédito.
- [cnpj.ia.br vs ReceitaWS](https://cnpj.ia.br/comparar/receitaws.md): fatos com fonte e data por linha, quando escolher cada um, migração campo a campo.
- [cnpj.ia.br vs BrasilAPI](https://cnpj.ia.br/comparar/brasilapi.md): BrasilAPI e Minha Receita resolvem o cadastro puro em volume baixo; comparação e migração campo a campo.

## Empresa
- [Sobre](https://cnpj.ia.br/sobre.md), [Segurança](https://cnpj.ia.br/seguranca.md), [Status](https://status.cnpj.ia.br), [Changelog](https://cnpj.ia.br/docs/changelog.md)
- [Termos](https://cnpj.ia.br/termos), [Privacidade](https://cnpj.ia.br/privacidade), [Uso aceitável](https://cnpj.ia.br/uso-aceitavel)
- [Glossário dev](https://cnpj.ia.br/glossario.md): situação cadastral, motivo, qualificação do sócio, natureza jurídica, código IBGE, dígito verificador, matriz e filial; cada termo com tabela de valores e gêmea `.md`.
- [Bundle OKF](https://cnpj.ia.br/okf/index.md): bundle Open Knowledge Format com um arquivo por conceito do produto, gerado no build das mesmas fontes do site.

## Dados
- [Quantas empresas existem no Brasil? Radiografia dos CNPJs](https://cnpj.ia.br/quantas-empresas-existem-no-brasil.md): distribuição dos CNPJs por situação, porte, UF, Simples, MEI e CNAE, e aberturas por mês, com a data da base; CSV e JSON em https://cnpj.ia.br/dados/empresas-brasil/latest.csv e /latest.json.

## Fatos
- Fonte primária: dados abertos da Receita Federal, atualizados mensalmente; enriquecimentos da Oportunidados.
- A base é mensal, não instantânea. meta.data_as_of informa a data da base em toda resposta de consulta, busca e filtro; a janela de atualização é publicada.
- Nunca retorna CPF de sócio ou representante. Pedidos de remoção (LGPD) valem para site e API.
- CNPJ alfanumérico suportado.
- Cobrança só em resposta 200. Franquia com hard cap; nada é cobrado sem ação do cliente.
- Não faz KYC, score de crédito nem consulta de dívidas.
