Para desenvolvedores

API de consulta CNPJ

JSON simples, servidores em São Paulo e dados atualizados a cada publicação da Receita Federal. Totalmente gratuita.

Sem chave

Grátis

Para testar e integrações leves

  • 20 consultas por minuto, 500 por dia (por IP)
  • Empresa, sócios, CNAE, filiais e histórico
  • Lote de até 100 CNPJs (300 por dia)
  • Validação de CNPJ ilimitada

Chave gratuita

Grátis

Para integrar ao seu sistema

  • 300 consultas por dia
  • 20 consultas por minuto
  • Lote de até 100 CNPJs por requisição
  • Identificação do seu projeto
Pedir chave grátis

Precisa de mais volume? Escreva para contato@olhocnpj.com.br.

Autenticação

Envie sua chave no cabeçalho X-API-Key. Sem chave, a API aceita poucas consultas por minuto por IP (uso do próprio site).

curl -H "X-API-Key: SUA_CHAVE" https://olhocnpj.com.br/api/v1/cnpj/00000000000191

Os limites restantes vêm nos cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Ao estourar o limite, a resposta é 429.

Endpoints

GET/api/v1/cnpj/{cnpj}

Dados completos do estabelecimento: cadastro, situação, CNAEs, sócios (QSA), endereço, contato, Simples/MEI e regime tributário. Aceita CNPJ com ou sem máscara, numérico ou alfanumérico. Estrutura compatível com a BrasilAPI/Minha Receita, o que facilita a migração.

{
  "cnpj": "00000000000191",
  "razao_social": "BANCO DO BRASIL SA",
  "nome_fantasia": "DIRECAO GERAL",
  "descricao_situacao_cadastral": "ATIVA",
  "data_inicio_atividade": "1966-08-01",
  "cnae_fiscal": 6422100,
  "cnae_fiscal_descricao": "Bancos múltiplos, com carteira comercial",
  "cnaes_secundarios": [{ "codigo": 6499999, "descricao": "..." }],
  "natureza_juridica": "Sociedade de Economia Mista",
  "capital_social": 120000000000.0,
  "uf": "DF", "municipio": "BRASILIA",
  "qsa": [{ "nome_socio": "...", "qualificacao_socio": "Diretor", "data_entrada_sociedade": "2023-01-05" }],
  "_fonte": "base", "_atualizado_em": "2026-11-09"
}

GET/api/v1/cnpj/{cnpj}/filiais?pagina=1&limite=50

Todos os estabelecimentos com a mesma raiz (8 primeiros caracteres): matriz e filiais, com situação e localização.

GET/api/v1/cnpj/{cnpj}/historico

Alterações detectadas entre as publicações mensais da Receita: razão social, nome fantasia, endereço, capital social, situação, CNAE, Simples/MEI e entrada/saída de sócios.

GET/api/v1/busca?q=padaria&uf=SP&municipio=CAMPINAS&situacao=ATIVA

Busca por razão social ou nome fantasia, com filtros opcionais por UF, município e situação. Paginada. Disponível para uso no site (5 buscas por minuto, 50 por dia por IP).

POST/api/v1/lote

Consulta até 100 CNPJs por requisição (até 300 por dia sem chave).

curl -X POST https://olhocnpj.com.br/api/v1/lote \
  -H "X-API-Key: SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"cnpjs": ["00000000000191", "33.000.167/0001-01"]}'

GET/api/v1/validar/{cnpj}

Validação de dígitos verificadores, sem consumir cota.

GET/api/v1/status

Saúde da API e data da base da Receita Federal carregada.

Códigos de resposta

CódigoSignificado
200Sucesso
400CNPJ inválido (dígitos verificadores incorretos ou formato errado)
401Chave de API inválida ou revogada
404CNPJ não encontrado
429Limite de consultas excedido
503Base temporariamente indisponível (ex.: durante a atualização mensal)