API EmpresaAPI

Autenticação

Gere uma chave em API dentro da plataforma. Envie a chave de uma destas formas:

?Token=eapi_...                 (parâmetro Token na URL)
X-Api-Key: eapi_...
Authorization: Bearer eapi_...

Toda resposta traz RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Em 429, respeite o Retry-After.

GET /api/v1/consulta

Com CNPJ de 14 caracteres retorna um objeto. Com CNPJ base de 8 (ex.: 21.792.257) retorna a lista de estabelecimentos, com matriz_e_filiais vazio, 1 (matriz) ou 2 (filiais), até 1.000 itens.

curl "https://www.empresaapi.com.br/api/v1/consulta?Token=SUA_CHAVE&Cnpj=11222333000181"

{
  "cnpj": "11222333000181",
  "razao": "EMPRESA EXEMPLO LTDA",
  "fantasia": "EXEMPLO",
  "ddd_1": "48", "tel_1": "33334444", "ddd_2": null, "tel_2": null,
  "email": "[email protected]",
  "site": null,
  "cnae_principal": "6203100 - Desenvolvimento e licenciamento de programas de computador não customizáveis",
  "cnae_secundario": "6201501,6311900",
  "log_tipo": "RUA", "log_nome": "DAS FLORES", "log_num": "100", "log_comp": null,
  "log_bairro": "CENTRO", "log_municipio": "FLORIANOPOLIS", "log_uf": "SC", "log_cep": "88010000",
  "matriz": "1",
  "situacao_cadastral": "2",
  "data_sit_cad": "20150202",
  "natureza_juridica": "Sociedade Empresária Limitada",
  "data_abertura": "20150202",
  "opcao_mei": "N", "data_mei": "00000000", "data_exc_mei": "00000000",
  "opcao_simples": "N", "data_simples": null, "data_exc_simples": "00000000",
  "porte": "3",
  "capital_social": "250000",
  "regime_tributario": "LUCRO PRESUMIDO",
  "faturamento": null,
  "quadro_funcionarios": null,
  "programas_especiais": [],
  "0": {
    "socios_nome": "NOME DO SOCIO",
    "socios_cpf_cnpj": "***123456**",
    "socios_entrada": "20150202",
    "socios_qualificacao": "Sócio-Administrador",
    "socios_faixa_etaria": "4"
  },
  "historicoDividasPorTrimestre": [],
  "historicoRegimePorAno": [{ "ano": "2024", "regime": "LUCRO PRESUMIDO" }]
}

Campos que a base pública não traz (site, faturamento, quadro_funcionarios, programas especiais e dívidas) vêm vazios. O regime tributário vem da ECF publicada pela Receita ou da opção pelo Simples Nacional.

GET /api/v1/empresas

Lista empresas por filtros, no mesmo formato de objeto da consulta (sem sócios). Pagine com o proximo_cursor da resposta. GET /api/v1/empresas/contagem recebe os mesmos filtros e devolve a quantidade (exata até 200 mil).

curl "https://www.empresaapi.com.br/api/v1/empresas?Token=SUA_CHAVE&uf=SC&cnae=5611201&situacao=2&com_telefone=S&limite=100"

{ "quantidade": 100, "proximo_cursor": "11222333000181", "resultados": [ ... ] }

Erros

Erros seguem a RFC 9457 em application/problem+json, com code, detail, resolution e o campo legado Erro.

Migrando de outra API

Aponte a integração para www.empresaapi.com.br e use a sua chave no parâmetro Token. A rota legada /acesso/RetornoJson.php também responde, com o header Deprecation.