Endpoints · Empresas
Consulta unitária de empresa por CNPJ
Retorna todos os dados públicos da empresa: razão social, endereço, CNAE, situação cadastral, QSA (sócios), regime tributário (Simples/MEI).
O campo enriquecimento traz dados cruzados na web (cache) quando disponíveis — sem custo extra.
Custo:
- 1 consulta por chamada base (refund se CNPJ não existir).
- +3 consultas quando ?enriquecer=true — dispara enriquecimento ativo com dados cruzados na web. Total: 4 consultas.
Nos planos com API, 1 consulta = 0,5 crédito.
Parâmetros
| Nome | Em | Obrigatório | Descrição |
|---|---|---|---|
cnpj |
path | sim | CNPJ com ou sem máscara. Aceita 14 dígitos. |
enriquecer |
query | não | Quando `true`/`1`, dispara enriquecimento ativo com dados cruzados na web e cobra +3 consultas. Sem o flag, retorna apenas o cache existente (incluído na consulta base). |
Respostas
| Status | Descrição |
|---|---|
| 200 | Dados da empresa. |
| 401 | Token ausente, inválido ou revogado. |
| 402 | Créditos insuficientes pra completar a operação. |
| 403 | Plano não permite uso da API ou escopo insuficiente. |
| 404 | Recurso não encontrado (CNPJ inexistente, job_id inválido, etc.). |
| 422 | Body ou query params inválidos. |
| 429 | Excedeu o rate limit. Veja header Retry-After. |
Exemplo curl
curl -H "Authorization: Bearer leadcnpj_live_..." \
https://leadcnpj.com.br/api/v1/empresa/12345678000190Campos retornados em data
| Campo | Tipo | Descrição |
|---|---|---|
cnpj | string | 14 dígitos sem máscara. Ex: 12345678000190 |
cnpj_formatado | string | CNPJ com máscara para apresentação. Ex: 12.345.678/0001-90 |
cnpj_basico | string | Ex: 12345678 |
razao_social | string | Normalizado: Title Case com conectores pt-BR em minúscula. Acrônimos legais (LTDA, ME, EPP, EIRELI, S/A) e UFs preservados em CAPS. |
nome_empresa | string | razao_social sem prefixo numérico comum em MEI/EI (ex: '12345678901 FULANO DA SILVA' → 'Fulano da Silva'). Para empresas LTDA/SA é igual a razao_social. |
nome_fantasia | string | Normalizado (Title Case). |
matriz_filial | string | Valores: matriz, filial. |
situacao | object | |
data_inicio_atividades | string | Ex: 20100515 |
natureza_juridica | object | |
porte_empresa | object | |
capital_social | number | |
cnae_principal | object | |
cnae_secundario | array<object> | |
endereco | object | Todos os campos normalizados (Title Case pt-BR). CNPJs sem cadastro do RFB podem ter campos individuais null. |
contato | object | |
regime_tributario | object | |
qsa | array<Socio> | Quadro de Sócios e Administradores. Dado público da Receita Federal. |
enriquecimento | object |