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 · Enriquecimento
Status e resultado de job assíncrono de enriquecimento
Polling do job criado por POST /enriquecer com mais de 100 CNPJs. Retorna status (queued/running/completed/failed) e, quando completed, os resultados em data.
Parâmetros
| Nome | Em | Obrigatório | Descrição |
|---|---|---|---|
job_id |
path | sim |
Respostas
| Status | Descrição |
|---|---|
| 200 | Status do job. |
| 401 | Token ausente, inválido ou revogado. |
| 404 | Recurso não encontrado (CNPJ inexistente, job_id inválido, etc.). |
| 429 | Excedeu o rate limit. Veja header Retry-After. |
Exemplo curl
curl -H "Authorization: Bearer leadcnpj_live_..." \
https://leadcnpj.com.br/api/v1/enriquecer/550e8400-e29b-41d4-a716-446655440000