Skip to content
GET/conversations/{conversationId}

Get a conversation

Get a single conversation by ID. Requires a team-role API key.

Parameters

NameInTypeDescription
conversationIdrequiredpathstringConversation ID

Response

Conversation details

FieldTypeDescription
idrequiredstringTypeID - a type-prefixed UUID
statusrequired"open" | "pending" | "closed"Current conversation status
channelrequired"live_chat" | "email" | "web_form"Channel the conversation arrived on
priorityrequired"none" | "low" | "medium" | "high" | "urgent"Agent-set triage priority
subjectrequiredstring | nullConversation subject line, null for live-chat threads
visitorPrincipalIdrequiredstringPrincipal ID of the visiting user
visitorEmailrequiredstring | nullCaptured contact email for the visitor, null if not provided
assignedAgentPrincipalIdrequiredstring | nullPrincipal ID of the assigned agent, null if unassigned
lastMessageAtrequiredstringISO 8601 timestamp
resolvedAtrequiredstring | nullWhen the conversation was resolved, null while still active
createdAtrequiredstringISO 8601 timestamp

Errors

401Unauthorized
404Conversation not found

Example request

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