Skip to main content

GET /v1/leads

GET/v1/leads
scope: leads.read 0 credits

List leads with filters and pagination.

info

Leads are aggregated from replies — one lead = unique email + campaign combination.

Query parameters

ParamTypeDefaultDescription
campaign_iduuidFilter by campaign
classificationstringhot, warm, cold, not_interested, ooo
sinceISO 8601Only leads with replies after this date
limitinteger50Max 100
offsetinteger0Pagination offset

Try it

GET/v1/leads
Saved locally in your browser
Query Parameters
Filter by campaign UUID
hot · warm · cold · not_interested · ooo
Max 100
Pagination offset
URLhttps://slazbvfvliieskvkjtav.supabase.co/functions/v1/api-gateway/v1/leads

Enter your API key above to send requests

Response

{
"leads": [{
"email": "john@acme.com",
"name": "John Doe",
"campaign_id": "abc-123",
"campaign_name": "Q1 SaaS Outreach",
"client_name": "Agency Client A",
"classification": "hot",
"reply_count": 3,
"last_reply_at": "2026-03-19T14:30:00Z"
}],
"count": 1,
"total_count": 147,
"limit": 20,
"offset": 0,
"has_more": true
}