Skip to main content
QUERY
conversations(ids: [String], departmentId: String, status: ConversationStatus, unAssigned: Boolean, tag: String, integrationType: String, integrationId: String, participating: String, awaitingResponse: String, starred: String, startDate: String, endDate: String, segment: String, assignedUserId: String, sortField: String, sortDirection: SortDirection, page: Int, perPage: Int): ConversationListResponse

Arguments

ids
[String]

Filter by specific conversation IDs

departmentId
String

Filter by department ID

status
ConversationStatus

Filter by conversation status

unAssigned
Boolean

Filter unassigned conversations only ('true' to get unassigned, 'false' to get assigned, keep empty for no filter)

tag
String

Filter by tag ID or name

integrationType
String

Filter by integration type (e.g., 'messenger', 'email', 'facebook', 'whatsapp')

integrationId
String

Filter by specific integration ID

participating
String

Filter conversations where current user is participating ('true'/'false')

awaitingResponse
String

Filter conversations where customer awaiting response ('true'/'false')

starred
String

Filter starred/favorited conversations ('true'/'false')

startDate
String

Filter by start date (ISO date string)

endDate
String

Filter by end date (ISO date string)

segment
String

Filter by customer segment ID

assignedUserId
String

Filter by assigned user/agent ID

sortField
String

Field to sort results by (e.g., 'createdAt', 'updatedAt')

sortDirection
SortDirection

Sort direction: 'asc' for ascending, 'desc' for descending

page
Int

Page number (1-based, default: 1)

perPage
Int

Number of items per page (default: 20, max: 100)

Returns

ConversationListResponse
data
[Conversation]

The list of conversations for the current page.

pagination
PaginationInfo!

Pagination metadata.

Query
Response
Last modified on August 8, 2026

Related topics

ConversationConversationStatusconversationsAssignconversationsUnassignconversationCounts