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
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
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
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ódigo | Significado |
|---|---|
200 | Sucesso |
400 | CNPJ inválido (dígitos verificadores incorretos ou formato errado) |
401 | Chave de API inválida ou revogada |
404 | CNPJ não encontrado |
429 | Limite de consultas excedido |
503 | Base temporariamente indisponível (ex.: durante a atualização mensal) |