List campaign leads
Leads
List campaign leads
List all leads in a campaign
Retrieve a paginated list of leads with their status and details.
Filtering Options
- status: Filter by lead status (PENDING, SENT, OPENED, REPLIED, BOUNCED, UNSUBSCRIBED)
- search: Search by email or name
- batch_id: Filter by lead batch (upload source)
Pagination
- page: Page number (1-based)
- limit: Items per page (1-100, default 20)
Example Usage
import requests
campaign_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.get(
f"https://api.coldsend.io/api/public/v1/campaigns/{campaign_id}/leads?status=PENDING",
headers={"X-API-Key": "your-api-key"}
)
print(response.json())
GET
List campaign leads
Authorizations
API key with format cs_live_xxx
Path Parameters
Query Parameters
Page number
Required range:
x >= 1Items per page
Required range:
1 <= x <= 100Filter by status
Search by email or name
Filter by batch ID

