Visão Geral

OpenCNPJ é uma API pública e gratuita para consultar dados cadastrais de empresas brasileiras por CNPJ. Informe um CNPJ válido e receba uma resposta JSON simples, pronta para uso em aplicativos, integrações e automações.

API

Estrutura da URL

A API expõe um único recurso:

GET https://api.opencnpj.org/{CNPJ}

Retorna os dados do CNPJ informado em JSON.

Parâmetros

Path {CNPJ} 14 dígitos. Formatos aceitos:

• Só números: 00000000000000
• Com pontuação completa: 00.000.000/0000-00
• Com pontos e barra (sem hífen): 00.000.000/000000

Filtro de datasets

Use datasets para escolher quais bases devem entrar na resposta. Sem filtro, a API retorna todas as bases publicadas para o CNPJ.

• receita dados cadastrais da Receita Federal.
• cno obras do Cadastro Nacional de Obras vinculadas ao CNPJ.

Consulta rápida

Exemplos

# só números
curl -s https://api.opencnpj.org/00000000000000 | jq

# com pontuação completa
curl -s "https://api.opencnpj.org/00.000.000/0000-00" | jq

# com pontos e barra (sem hífen)
curl -s "https://api.opencnpj.org/00.000.000/000000" | jq

# apenas dados da Receita Federal
curl -s "https://api.opencnpj.org/00000000000000?datasets=receita" | jq

# apenas CNO
curl -s "https://api.opencnpj.org/00000000000000?datasets=cno" | jq

# Receita Federal + CNO
curl -s "https://api.opencnpj.org/00000000000000?datasets=receita,cno" | jq

Resposta

Content-Type: application/json

Exemplo de resposta (campos podem variar):

{
  "cnpj": "00000000000000",
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "nome_fantasia": "EXEMPLO",
  "situacao_cadastral": "Ativa",
  "data_situacao_cadastral": "2000-01-01",
  "matriz_filial": "Matriz",
  "data_inicio_atividade": "2000-01-01",
  "cnae_principal": "0000000",
  "cnaes_secundarios": [
    "0000001",
    "0000002"
  ],
  "cnaes_secundarios_count": 2,
  "natureza_juridica": "Sociedade Empresária Limitada",
  "logradouro": "RUA EXEMPLO",
  "numero": "123",
  "complemento": "SALA 1",
  "bairro": "BAIRRO EXEMPLO",
  "cep": "00000000",
  "uf": "SP",
  "municipio": "SAO PAULO",
  "email": "[email protected]",
  "telefones": [
    {
      "ddd": "11",
      "numero": "900000000",
      "is_fax": false
    }
  ],
  "capital_social": "1000,00",
  "porte_empresa": "Microempresa (ME)",
  "opcao_simples": null,
  "data_opcao_simples": null,
  "opcao_mei": null,
  "data_opcao_mei": null,
  "QSA": [
    {
      "nome_socio": "SOCIO PJ EXEMPLO",
      "cnpj_cpf_socio": "00000000000000",
      "qualificacao_socio": "Sócio Pessoa Jurídica",
      "data_entrada_sociedade": "2000-01-01",
      "identificador_socio": "Pessoa Jurídica",
      "faixa_etaria": "Não se aplica"
    },
    {
      "nome_socio": "SOCIA PF EXEMPLO",
      "cnpj_cpf_socio": "***000000**",
      "qualificacao_socio": "Administrador",
      "data_entrada_sociedade": "2000-01-01",
      "identificador_socio": "Pessoa Física",
      "faixa_etaria": "31 a 40 anos"
    }
  ]
}

Códigos de status

• 200 CNPJ encontrado
• 404 CNPJ não encontrado
• 429 limite de requisições excedido

Autenticação e limites

• Autenticação: não requer chaves ou tokens.
• Rate limit: aceitamos picos de até 50 requisições/segundo por IP.

Disponibilidade

• API 100% estática servida na borda pela CDN da Cloudflare, com alto cache.
• Tempos típicos: MISS ~150 ms, HIT ~40 ms.
• Alta disponibilidade 24/7.

Dados

O OpenCNPJ publica múltiplas bases públicas em uma única API por CNPJ. Cada base tem atualização própria e pode ser solicitada separadamente pelo parâmetro datasets.

Total de CNPJs cadastrados na Receita Federal:
Última atualização geral:

Bases disponíveis na API

Carregando bases publicadas…

Download completo (ZIP)

Dataset público no BigQuery

Código Aberto

Este projeto é totalmente aberto: código, issues e discussões estão públicos para você auditar, contribuir e reutilizar.

Bibliotecas por Linguagem

Integrações mantidas pela comunidade para facilitar o uso do OpenCNPJ em diferentes linguagens.

Tem uma biblioteca em outra linguagem? Envie um PR para adicionarmos aqui.

Apoie

As doações incentivam o projeto e ajudam a manter a infraestrutura e evoluir a API.

As doações viabilizam as ações planejadas para diminuir ainda mais o tempo de resposta, aumentar a disponibilidade e manter a infraestrutura, e ainda garantem a coquinha do desenvolvedor 😉

Perguntas e Respostas