list_tickets
Retrieve tickets with optional filters such as category, stage, priority, agent, contact, date, or search text. Get a paginated list to locate specific tickets.
Instructions
List tickets with optional filters. Returns one page of results.
Args: category: Filter by category internal name (use list_ticket_categories to find valid names). stage: Ticket lifecycle stage — exact values (case-sensitive): 'OPEN' = agent actively working on it, 'WAIT' = reply sent, awaiting customer response, 'CLOSE' = resolved/solved, 'ARCHIVE' = resolved and archived. When user says "open tickets", use stage='OPEN'. priority: Filter by priority: LOW, MEDIUM, HIGH. user: Agent name — pass either a display name (e.g. 'John Doe') or login name (e.g. 'john.doe'). Display names are resolved automatically. You do NOT need to call list_users first. contact: Filter by contact internal ID (e.g. 'contact_674eda46162a8403430453'). NOT a person's name — call list_contacts(search='...') first to find the ID. search: Full-text search across ticket title and description (partial match). status: Filter by workflow status name (e.g. 'S0-Qualify', 'S1-Discovery'). Use list_statuses to see available status names. This filters on the ticket's statuses MN relation — useful for sales pipeline stages, custom workflows, etc. date_from: Filter tickets created on or after this date (YYYY-MM-DD). date_to: Filter tickets created on or before this date (YYYY-MM-DD). include_merged: Include tickets that were merged into other tickets (default: false). sort: Field to sort by. Useful values: edited (default), created, sla_deadtime, sla_close_deadline, last_activity. sort_dir: Sort direction: asc or desc (default: desc). skip: Number of records to skip for pagination (default: 0). take: Number of records to return (default: 50, max: 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | ||
| sort | No | edited | |
| take | No | ||
| user | No | ||
| stage | No | ||
| search | No | ||
| status | No | ||
| contact | No | ||
| date_to | No | ||
| category | No | ||
| priority | No | ||
| sort_dir | No | desc | |
| date_from | No | ||
| include_merged | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |