API REST · v1.0.0

Documentação da API LeadCNPJ

Integre o LeadCNPJ ao seu CRM, ERP ou ferramenta de automação. Consulte CNPJs, busque empresas por filtros firmográficos e enriqueça listas em lote — tudo via REST.

Endpoints · Empresas

Consulta unitária de empresa por CNPJ

GET /api/v1/empresa/{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).
- +1 consulta quando ?enriquecer=true — dispara enriquecimento ativo com dados cruzados na web. Total: 2 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 +1 consulta. 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/12345678000190