List campaigns

List all campaigns in your workspace

Retrieve a paginated list of campaigns with filtering and sorting options.

Filtering Options

• status: Filter by campaign status (DRAFT, ACTIVE, PAUSED, COMPLETED, FAILED)
• search: Search campaigns by name (case-insensitive partial match)
• days: Filter campaigns created in the last N days

Sorting Options

• sort_by: Field to sort by (name, status, created_at, launched_at, sent_count, reply_count)
• sort_order: Sort direction (asc, desc)

Pagination

• page: Page number (1-based)
• limit: Items per page (1-100, default 20)

Example Usage

import requests

response = requests.get(
    "https://api.coldsend.io/api/public/v1/campaigns?status=ACTIVE&sort_by=created_at&sort_order=desc",
    headers={"X-API-Key": "your-api-key"}
)

print(response.json())