curl --request GET \
--url https://api.superlead.app/v1/leads/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superlead.app/v1/leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.superlead.app/v1/leads/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "lead_0b5f8a3e-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
"name": "João Silva",
"phone": "+5511999999999",
"source": "Meta Ads",
"channel": "WhatsApp",
"entry_point": "ctwa",
"funnel_stage": "1º Contato",
"document": "123.456.789-01",
"document_type": "cpf",
"cep": "01310-100",
"address": "Av. Paulista",
"address_number": "1000",
"address_complement": null,
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"country": "BR",
"created_at": "2026-06-01T12:00:00.000Z"
}{
"error": {
"code": "invalid_api_key",
"message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}{
"error": {
"code": "lead_not_found",
"message": "No lead matches this recipient in your company. The API only messages existing leads.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}Buscar Lead por ID
Consulta o cadastro completo de um lead pelo id (lead_...) retornado na criação ou na busca por telefone.
Inclui dados de contato, atribuição de origem (source, channel, entry_point), documento (CPF/CNPJ), endereço completo e a etapa atual do funil (funnel_stage, pelo nome). Para mover o lead de etapa, use PUT /v1/leads/{id}/stage; para editar o cadastro, PATCH /v1/leads/{id}.
curl --request GET \
--url https://api.superlead.app/v1/leads/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superlead.app/v1/leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.superlead.app/v1/leads/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "lead_0b5f8a3e-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
"name": "João Silva",
"phone": "+5511999999999",
"source": "Meta Ads",
"channel": "WhatsApp",
"entry_point": "ctwa",
"funnel_stage": "1º Contato",
"document": "123.456.789-01",
"document_type": "cpf",
"cep": "01310-100",
"address": "Av. Paulista",
"address_number": "1000",
"address_complement": null,
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"country": "BR",
"created_at": "2026-06-01T12:00:00.000Z"
}{
"error": {
"code": "invalid_api_key",
"message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}{
"error": {
"code": "lead_not_found",
"message": "No lead matches this recipient in your company. The API only messages existing leads.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}Authorizations
Chave de API da sua empresa (sk_...). Crie no painel Superlead em Integrações → API e envie em toda chamada como Authorization: Bearer sk_.... Veja Autenticação.
Path Parameters
Id do lead (lead_...), retornado por POST /v1/leads, GET /v1/leads?phone=... ou GET /v1/leads/{id}.
Response
Lead encontrado — cadastro completo.
Id do lead no Superlead (lead_...). Estável — use nas demais chamadas.
"lead_0b5f8a3e-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
Nome do lead.
"João Silva"
Telefone em E.164. null para leads sem telefone exposto (username do WhatsApp).
"+5511999999999"
Origem do lead exibida no painel.
"Meta Ads"
Canal de origem.
"WhatsApp"
Ponto de entrada da conversão.
"ctwa"
Nome da etapa atual do funil. Para mover, use PUT /v1/leads/{id}/stage.
"1º Contato"
CPF ou CNPJ do lead.
"123.456.789-01"
Tipo do documento.
cpf, cnpj "cpf"
CEP do endereço.
"01310-100"
Logradouro.
"Av. Paulista"
Número.
"1000"
Complemento.
"Conjunto 51"
Bairro.
"Bela Vista"
Cidade.
"São Paulo"
Estado (UF).
"SP"
País.
"BR"
Data de criação do lead (ISO 8601, UTC).
"2026-06-01T12:00:00.000Z"
Was this page helpful?