Documentação da API LeadCNPJ

Endpoints · Sistema

Inclui empresa privada pelo CNPJ

Cadastro privado da integração, separado da base da Receita. Apenas CNPJ obrigatório. Não enriquece automaticamente nem cria contato. CNPJ duplicado na mesma conta: 409. Não propaga automaticamente campos para contatos existentes.

Parâmetros

Nome	Em	Obrigatório	Descrição
Idempotency-Key	header	sim	Reutilize ao repetir o mesmo pedido. Outro corpo com a mesma chave: 409.

Body da requisição

Campo	Tipo	Descrição
cnpj obrigatório	string	CNPJ de 14 dígitos com verificadores válidos; com ou sem pontuação.
razao_social	string
nome_fantasia	string
email	string
telefone	string
site	string
cidade	string
uf	string

Exemplo:

{
    "cnpj": "11222333000181",
    "razao_social": "Empresa Exemplo Ltda"
}

Respostas

Status	Descrição
201	Cadastro criado.
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 -X POST https://leadcnpj.com.br/api/v1/sistema/crm/empresas \
  -H "Authorization: Bearer leadcnpj_system_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"cnpj":"11222333000181","razao_social":"Empresa Exemplo Ltda"}'

Exemplo de resultado (201)

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"
    }
}