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

Plano, vencimento e créditos

GET /api/v1/sistema/conta

Retorna a conta vinculada à chave e o saldo compartilhado quando houver grupo. vencimento é a data do ciclo, não a data de bloqueio. Não consome créditos.

Respostas

StatusDescrição
200 Dados do sistema. meta.creditos_consumidos é sempre 0; datas sem fuso usam America/Sao_Paulo.
401 Chave inválida ou revogada.
403 Finalidade, conta, papel ou plano não permitem o acesso.
404 Recurso ausente ou fora da visão do titular.
405 A API do sistema aceita apenas GET.
422 Parâmetros inválidos.
429 Limite de chamadas atingido.
500 Leitura indisponível. Não representa saldo ou total zero.

Exemplo curl

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

Exemplo de resultado (200)

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

{
    "data": {
        "tipo_conta": "empresa",
        "id_grupo": 15,
        "plano": {
            "id": 21,
            "nome": "Growth",
            "vencimento": "2026-11-16"
        },
        "creditos_disponiveis": 677
    },
    "meta": {
        "creditos_consumidos": 0,
        "timezone": "America/Sao_Paulo"
    }
}