Pular para o conteúdo principal
GET
Listar leads

Buscar o lead pelo telefone (ex.: DataCrazy, n8n)

O caso mais comum: chegou uma conversa no CRM e você quer saber de onde aquele lead veio. Busque pelo telefone com ou sem +, DDI, espaços ou traços. Número brasileiro sem DDI ganha o 55 sozinho.
Pegue o id do lead retornado e chame Jornada do lead para ver os eventos e as UTMs.

Paginação

Use page e limit (até 100). Continue enquanto has_more for true.

Autorizações

Authorization
string
header
obrigatório

JWT da plataforma ou API key mtk_live_...

Parâmetros de consulta

container_id
string

Container a consultar (ObjectId, domínio ou MTC-XXXX). Dispensável com chave de API do container; obrigatório com chave do workspace.

Exemplo:

"MTC-AB12"

phone
string

Telefone do lead. Aceita qualquer formatação; número brasileiro sem DDI ganha o 55.

Exemplo:

"5511999998888"

email
string

E-mail exato do lead.

Exemplo:

"cliente@email.com"

document
string

CPF ou CNPJ, com ou sem pontuação.

Exemplo:

"123.456.789-00"

created_after
string<date-time>

Só leads criados a partir desta data (ISO 8601).

Exemplo:

"2026-11-01T00:00:00-03:00"

created_before
string<date-time>

Só leads criados até esta data (ISO 8601).

identified_only
boolean
padrão:true

true (padrão) devolve só leads com nome, e-mail, telefone ou documento. false inclui visitantes anônimos.

include_bots
boolean
padrão:false

Inclui leads marcados como bot.

order
enum<string>
padrão:desc

Ordem pela data de criação.

Opções disponíveis:
desc,
asc
page
integer
padrão:1
Intervalo obrigatório: x >= 1
limit
integer
padrão:50

Leads por página (1 a 100).

Intervalo obrigatório: 1 <= x <= 100

Resposta

Página de leads

object
string
Allowed value: "list"
data
object[]
page
integer
limit
integer
has_more
boolean