List conversations
List conversations
GET
List conversations
Retrieves a paginated list of conversations for the authenticated organization. Supports filtering by status, agent assignment, tags, and full-text search. Results can be ordered by priority, date, or longest wait time. Pagination is cursor-based for efficient traversal of large datasets.
Authorizations
Query Parameters
Maximum number of conversations to return per page.
Required range:
3 <= x <= 250Search query string. Supports filtering by status, agent, tags, and keywords. Examples:
- "status:opened" - Filter by status (opened, closed, spam, snoozed)
- "assigned:jared@piedpiper.com" - Filter by agent email
- "unassigned:true" - Show only unassigned conversations
- "tag:urgent" - Filter by tag
- "keyword search" - Full-text search in conversation content
Pagination cursor from the previous response to fetch the next page.
Sort order for conversations (priority, oldest, newest, or longest).
Available options:
priority, oldest, newest, longest