List leads
whatconverts_list_leadsRead-only
List tracked leads (phone calls, web forms, chats, texts, emails, events, transactions) with source/medium/campaign/keyword attribution, contact details, quote and sales values, call duration and transcripts. start_date is REQUIRED because WhatConverts otherwise returns only today's leads; a range is at most 400 days. A Profile key sees its own profile; an Agency key can narrow by account_id/profile_id. GET /leads.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| spam | No | true = only spam leads. | |
| order | No | Sort by date created: asc or desc (default desc). | |
| user_id | No | Only leads handled by this WhatConverts user id. | |
| end_date | No | Last day/time to include (UTC). Range from start_date at most 400 days. | |
| per_page | No | Results per page, 1-100 (default 25). | |
| quotable | No | Only leads with this quotable state. | |
| duplicate | No | true = only duplicate leads. | |
| lead_type | No | Only this lead type. | |
| account_id | No | Agency key only: only this account (see whatconverts_list_accounts). | |
| profile_id | No | Agency key only: only this profile. | |
| start_date | Yes | First day/time to include (UTC), e.g. 2026-10-01 or 2026-10-01T00:00:00Z. | |
| lead_medium | No | Traffic medium, e.g. cpc. | |
| lead_source | No | Traffic source, e.g. google. | |
| lead_status | No | Repeat or unique contacts. | |
| quote_value | No | Only leads with / without a quote value. | |
| sales_value | No | Only leads with / without a sales value. | |
| lead_content | No | Ad content. | |
| lead_keyword | No | Keyword. | |
| phone_number | No | Contact phone number, E.164 (+15551234567). | |
| email_address | No | Contact email address. | |
| lead_campaign | No | Campaign name. | |
| customer_journey | No | Include customer journey data (Elite plans only). |