API por CNPJ

Documentação da API EmpresAqui

Token no path. CNPJ sem pontuação. Resposta em JSON.

Começar Pela Consulta Abrir Exemplo

GET https://www.empresaqui.com.br/api/{token}/{cnpj}

CNPJ com 14 números. Sem pontos. Sem barra. Sem hífen.

Como funciona

1. Gere o token. Acesse acesso/api e clique em Gerar Novo Token.
2. Monte a URL. Use o token no path e envie o CNPJ com 14 números, sem pontuação.
3. Faça a consulta. Chame /api/{token}/{cnpj} no navegador, cURL ou PHP.
4. Leia o JSON. O retorno traz os dados da empresa para tratamento na sua aplicação.

Autenticação

Token API

Gerado em /acesso/api para liberar a consulta.

URL Pública

empresaqui.com.br

Domínio público onde a consulta da API fica disponível.

Endpoint

GET /acesso/RetornoJson.php

Use Token e Cnpj na query string. CNPJ completo retorna em objeto único; CNPJ base retorna em lista.

Rate Limit

1 req/seg

Limite de requisição aplicado para cada token.

Visão Geral

Leitura rápida

O básico para entender a API em menos de um minuto.

Fluxo simples

Entre em https://www.empresaqui.com.br/acesso/api.
Clique em Gerar Novo Token.
Guarde o token.
Monte a URL da consulta.
Envie um CNPJ completo ou um CNPJ base.
Receba o JSON.

O que a API entrega

Dados básicos.
Endereço.
Dados tributários e cadastrais.
Programas especiais.
Sócios no formato atual.
Dívidas no formato atual.
Históricos por trimestre e por ano.

Autenticação

Como obter o token

Sem token, sem consulta.

Passo a passo

Acesse https://www.empresaqui.com.br/acesso/api.
Clique em Gerar Novo Token.
Copie o valor gerado.
Use esse token na query string da URL.

Regras observadas

Token vai na query string.
Token inválido retorna 401.
Usuário sem permissão retorna 403.
Teste gratuito: 50 requisições.

GET https://www.empresaqui.com.br/acesso/RetornoJson.php?Token={token}&Cnpj={cnpj} Produção

Token obrigatório CNPJ obrigatório Resposta JSON

Consulta

Como fazer a requisição

URL, parâmetros, regra do CNPJ e exemplos.

Parâmetros da query string

Parâmetro	Tipo	Regra	Exemplo
`Token`	string	Gerado na tela da API	`tok_demo_1234567890abcdef`
`Cnpj`	string	14 dígitos para retorno em objeto único, ou 8 dígitos para CNPJ base.	`21792257000101` ou `21.792.257`
`matriz_e_filiais`	string	Opcional para CNPJ base. Vazio = matriz e filiais. 1 = somente matriz. 2 = somente filiais.	`1`

Montar URL

Token

CNPJ ou CNPJ base

URL gerada https://www.empresaqui.com.br/acesso/RetornoJson.php?Token=tok_demo_1234567890abcdef&Cnpj=21.792.257&matriz_e_filiais=1

Abrir URL

Dois modos de consulta.
CNPJ completo com 14 dígitos retorna em objeto único. CNPJ base com 8 dígitos, como 53.049.753, retorna a estrutura em lista.

curl "https://www.empresaqui.com.br/acesso/RetornoJson.php?Token=tok_demo_1234567890abcdef&Cnpj=21.792.257&matriz_e_filiais=1"

<?php
$url = "https://www.empresaqui.com.br/acesso/RetornoJson.php?Token=tok_demo_1234567890abcdef&Cnpj=21.792.257&matriz_e_filiais=1";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$dados = json_decode($response, true);

Resposta

Exemplo de resposta

Exemplo resumido do retorno em JSON.

{
  "cnpj_base": "21.792.257",
  "filtro_matriz_filial": "somente_matriz",
  "quantidade": 1,
  "resultados": [
    {
      "cnpj": "21792257000101",
      "razao": "EMPRESAQUI TECNOLOGIA DA INFORMACAO LTDA",
      "fantasia": "EMPRESAQUI",
      "ddd_1": "33",
      "tel_1": "999580012",
      "ddd_2": null,
      "tel_2": null,
      "email": "faturamento@empresaqui.com.br",
      "site": "www.empresaqui.com.br",
      "matriz": "1",
      "situacao_cadastral": "2",
      "porte": "3",
      "programas_especiais": [],
      "historicoDividasPorTrimestre": [
        {
          "trimestreAno": "1º TRI/2025",
          "valor": "NAO POSSUI"
        }
      ],
      "historicoRegimePorAno": []
    }
  ]
}

Campos

Campos da resposta por grupo

Referência dos campos do retorno.

Dados básicos

Campo	Tipo	Exemplo	Observação
`cnpj`	string	21792257000101	14 dígitos. Sem pontuação.
`razao`	string	EMPRESAQUI TECNOLOGIA DA INFORMACAO LTDA	Razão social.
`fantasia`	string	EMPRESAQUI	Nome fantasia.
`email`	string \| null	faturamento@empresaqui.com.br	Email.
`ddd_1`	string \| null	33	DDD do telefone 1.
`tel_1`	string \| null	999580012	Telefone 1.
`ddd_2`	string \| null	null	DDD do telefone 2.
`tel_2`	string \| null	null	Telefone 2.
`site`	string \| null	www.empresaqui.com.br	Sem protocolo.

Endereço

Campo	Tipo	Exemplo	Observação
`log_tipo`	string \| null	AVENIDA	Tipo do logradouro.
`log_nome`	string \| null	ANTONIO GIL VELOSO	Nome do logradouro.
`log_num`	string \| null	1818	Número.
`log_comp`	string \| null	LOJA 01	Admite espaços duplicados.
`log_bairro`	string \| null	PRAIA DA COSTA	Bairro.
`log_municipio`	string \| null	VILA VELHA	Município.
`log_uf`	string \| null	ES	UF.
`log_cep`	string \| null	29101018	CEP sem máscara.

Dados tributários e cadastrais

Campo	Tipo	Exemplo	Observação
`cnae_principal`	string	6203100 - ...	Formato: código + descrição.
`cnae_secundario`	string \| null	4761001,5811500,...	Formato CSV. Não usa array.
`matriz`	string	1	1 = MATRIZ. 2 = FILIAL.
`situacao_cadastral`	string	2	1 = NULA. 2 = ATIVA. 3 = SUSPENSA. 4 = INAPTA. 8 = BAIXADA.
`data_sit_cad`	string \| null	20150202	Formato AAAAMMDD.
`natureza_juridica`	string \| null	Sociedade Empresária Limitada	Texto pronto.
`data_abertura`	string \| null	20150202	Formato AAAAMMDD.
`opcao_mei`	string \| null	N	S ou N.
`data_mei`	string \| null	00000000	Sem data útil quando zerado.
`data_exc_mei`	string \| null	00000000	Sem data útil quando zerado.
`opcao_simples`	string \| null	N	S ou N.
`data_simples`	string \| null	null	Valor nulo: `null`.
`data_exc_simples`	string \| null	20240630	Formatos aceitos: data, `null` ou `00000000`.
`porte`	string	3	0, 1, 3 ou 5.
`capital_social`	string \| null	250000	Valor numérico em texto.
`regime_tributario`	string \| null	PRESUMIDO OU LUCRO REAL	Texto pronto.
`faturamento`	string \| null	R$ 360001,00 a R$ 4800000,00	Faixa em texto.
`quadro_funcionarios`	string \| null	20 A 99 COLABORADORES	Faixa em texto.

Programas especiais

programas_especiais: array. Aceita lista vazia.

EMPRESA CIDADÃ
IMPORTAÇÃO E EXPORTACAO
PAT
RECUPERACAO JUDICIAL

Históricos

historicoDividasPorTrimestre[] com trimestreAno e valor.
historicoRegimePorAno[] com ano e regime.
valor usa NAO POSSUI quando não há registro.
historicoRegimePorAno usa minúsculas.

Sócios no formato atual

O formato atual não usa socios[]. Os sócios entram em chaves numéricas no objeto raiz.

Campo	Exemplo
`socios_nome`	DANILLO ROCHA ALVES RODRIGUES
`socios_cpf_cnpj`	*791596
`socios_entrada`	20150202
`socios_qualificacao`	SÓCIO-ADMINISTRADOR
`socios_faixa_etaria`	4

Dívidas no formato atual

O formato atual não usa dividas[]. As dívidas entram em chaves numéricas.

Campo	Exemplo
`dividas_numero`	123456789
`dividas_tipo_devedor`	PJ
`dividas_tipo_situacao`	ATIVA
`dividas_inscricao`	INSCRITA
`dividas_receita`	RECEITA FEDERAL
`dividas_data`	20240131
`dividas_indicador`	N
`dividas_valor`	1500.75

Formatos que exigem tratamento

00000000 significa data sem valor útil.
null representa ausência de valor.
cnae_secundario usa CSV. Para array, separar por vírgula.
site retorna sem https://.

Códigos

Como interpretar os códigos

Tabela de referência dos códigos do retorno.

`matriz`

Código	Significado
1	MATRIZ
2	FILIAL

`situacao_cadastral`

Código	Significado
1	NULA
2	ATIVA
3	SUSPENSA
4	INAPTA
8	BAIXADA

`porte`

Código	Significado
0	NÃO INFORMADO
1	MICROEMPRESA
3	PEQUENO PORTE
5	MÉDIO/GRANDE PORTE

`socios_faixa_etaria`

Código	Significado
0	NÃO SE APLICA
1	0 A 12 ANOS
2	13 A 20 ANOS
3	21 A 30 ANOS
4	31 A 40 ANOS
5	41 A 50 ANOS
6	51 A 60 ANOS
7	61 A 70 ANOS
8	71 A 80 ANOS
9	ACIMA DE 80 ANOS

Erros

Códigos de erro

Erros HTTP retornados pela API e significado.

401

Token inválido

Token ausente, inválido ou não aceito pela API.

{"Erro":"Token Inválido"}

403

Acesso negado

Token sem permissão para executar a consulta.

{"Erro":"Usuário sem permissão"}

404

CNPJ não encontrado

CNPJ sem registro disponível para retorno na API.

{"Erro":"CNPJ não encontrado."}

429

Limite de requisições

Limite por token atingido. Aguarde antes da próxima consulta.

Rate limit exceeded. Accepted 1 per 1 second. Try again after 1 second.

Exemplo

Consulta por CNPJ

Exemplo interativo da operação de consulta.

Exemplo de consulta

Fonte: ./openapi.json

Exemplo não carregou. Motivo comum: bloqueio do CDN externo. Arquivo principal disponível em http://localhost:8080/acesso/DocsAPI/openapi.json.