Get a paginated list of participants from a sweepstakes (20 per page). Use fetch_sweepstakes first to get the sweepstakes_token. Supports search by name, email, or phone, and filtering by opt-in date or date range. Results are sorted by creation date (newest first). For full participant details, use get_participant with a specific email, phone, or token. NEVER fabricate or hallucinate participant data — only report what the API returns. Use them internally for tool chaining but present only human-readable information (names, emails, phones, dates).
# fetch_participants
## When to use
Get a paginated list of participants from a sweepstakes (20 per page). Use fetch_sweepstakes first to get the sweepstakes_token. Supports search by name, email, or phone, and filtering by opt-in date or date range. Results are sorted by creation date (newest first). For full participant details, use get_participant with a specific email, phone, or token. NEVER fabricate or hallucinate participant data — only report what the API returns. Use them internally for tool chaining but present only human-readable information (names, emails, phones, dates).
## Pre-calls required
1. fetch_sweepstakes if the user gave you a sweepstakes name instead of a token
## Parameters to validate before calling
- sweepstakes_token (string, required) — The sweepstakes token (UUID format)
- page (number, optional) — Page number for pagination (default: 1, 20 results per page)
- search (string, optional) — Search by first name, last name, email, or phone number (case-insensitive)
- opt_in_date (string, optional) — Filter by specific opt-in date (YYYY-MM-DD)
- start_date (string, optional) — Start of date range filter (YYYY-MM-DD, requires end_date)
- end_date (string, optional) — End of date range filter (YYYY-MM-DD, requires start_date)