Skip to main content
GET
Lista leads

Authorizations

Authorization
string
header
required

Authorization: Bearer mcp_… — gere em Configurações → Tokens de API.

O token tem modo read ou write. Um token read responde 403 a qualquer verbo que não seja GET. As capacidades do token são a interseção com as da pessoa que o emitiu: se ela perder acesso na grade de Equipe, o token perde junto, sem ninguém revogar nada.

Query Parameters

stage
string

Nome da etapa do funil, ex. Venda.

origin
enum<string>
Available options:
ctwa,
link,
organic
phone
string

Acha o lead pelo telefone. Aceita qualquer formatação — +5547984310462, 554784310462 e (47) 98431-0462 casam com o mesmo lead, porque a comparação é por DDD + os 8 últimos dígitos (o nono dígito entra e sai conforme o provedor).

É o caminho para quem recebe um postback de pagamento: uma chamada em vez de paginar a base.

Example:

"+5547984310462"

limit
integer
default:50
Required range: x <= 200
cursor
string

next_cursor da página anterior. A paginação é por cursor, não por offset: o worker escreve lead o tempo todo, e offset repetiria ou pularia linha no meio da varredura.

Response

OK

data
object[]
next_cursor
string | null