GET/conversations

List conversations

Returns a paginated list of support conversations. Requires a team-role API key.

Parameters

Name	In	Type	Description
`status`	query	`"open" \| "pending" \| "closed"`	Filter by conversation status
`priority`	query	`"none" \| "low" \| "medium" \| "high" \| "urgent"`	Filter by triage priority
`assignedAgentPrincipalId`	query	`string`	Filter by assigned agent principal ID
`cursor`	query	`string`	Pagination cursor from previous response
`limit`	query	`integer`	Items per page (max 100)(default: `20`)

List of conversations

Returns an array of objects:

Field	Type	Description
`id`required	`string`	TypeID - a type-prefixed UUID
`status`required	`"open" \| "pending" \| "closed"`	Current conversation status
`channel`required	`"live_chat" \| "email" \| "web_form"`	Channel the conversation arrived on
`priority`required	`"none" \| "low" \| "medium" \| "high" \| "urgent"`	Agent-set triage priority
`subject`required	`string \| null`	Conversation subject line, null for live-chat threads
`visitorPrincipalId`required	`string`	Principal ID of the visiting user
`visitorEmail`required	`string \| null`	Captured contact email for the visitor, null if not provided
`assignedAgentPrincipalId`required	`string \| null`	Principal ID of the assigned agent, null if unassigned
`lastMessageAt`required	`string`	ISO 8601 timestamp
`resolvedAt`required	`string \| null`	When the conversation was resolved, null while still active
`createdAt`required	`string`	ISO 8601 timestamp

401Unauthorized

curl \
  "https://feedback.quackback.io/api/v1/conversations" \
  -H "Authorization: Bearer qb_your_api_key_here"