API REST · v1.2.0

Documentação da API LeadCNPJ

Consulte dados de prospecção ou conecte seu sistema ao CRM: leads, oportunidades, plano, créditos e agentes de IA. Cada finalidade usa uma chave própria.

Endpoints · Sistema

Consulta empresa privada da integração

GET /api/v1/sistema/crm/empresas/{cnpj}

Não é consulta à Receita nem à base pública. Somente empresa incluída nesta conta pelos endpoints de integração; aplica a visibilidade de quem a criou.

Parâmetros

NomeEmObrigatórioDescrição
cnpj path sim CNPJ numérico sem pontuação.

Respostas

StatusDescrição
200 Registro consultado ou atualizado.
401 Chave inválida.
403 Escopo, permissão ou limite do CRM não permite a operação.
404 Recurso inexistente ou fora da visão.
409 Cadastro duplicado ou conflito de idempotência/identificador externo.
422 Campos inválidos, desconhecidos ou supressão de dados.
429 Limite de chamadas.
503 Migração ou verificação indisponível.

Exemplo curl

curl -H "Authorization: Bearer leadcnpj_system_..." \
     https://leadcnpj.com.br/api/v1/sistema/crm/empresas/11222333000181

Exemplo de resultado (200)

Dados fictícios. Campos sem informação podem ser null.

{
    "data": {
        "id": 42,
        "cnpj": "11222333000181",
        "razao_social": "Empresa Exemplo Ltda",
        "nome_fantasia": "Exemplo",
        "email": "comercial@example.com",
        "telefone": "1133334444",
        "site": "https://example.com",
        "cidade": "São Paulo",
        "uf": "SP",
        "criado_em": "2026-10-16 09:00:00",
        "atualizado_em": "2026-10-16 09:00:00"
    },
    "meta": {
        "creditos_consumidos": 0,
        "consultado_em": "2026-10-16T09:00:00-03:00",
        "timezone": "America/Sao_Paulo"
    }
}