Get a single conversation by ID

Retrieves detailed information about a specific conversation, including:

  • Conversation metadata (status, assignee, tags, timestamps)
  • Associated contact information
  • AI assistant interaction status (if Aura is enabled)

Returns 404 if the conversation doesn't exist, or 403 if you don't have permission
to access it (e.g., it's assigned to another teammate in a restricted inbox).

Response field values

tag - Priority tag assigned to the conversation:

  • none: No tag assigned
  • in_progress: Being actively worked on
  • waiting: Waiting for customer response or external action
  • priority: High priority, requires immediate attention

origin_channel - Channel where the conversation started:

  • in_app: Live chat widget on your website/app
  • email: Email integration
  • facebook: Facebook Messenger
  • whatsapp: WhatsApp Business

initiated_by - Who started the conversation:

  • contact: Contact initiated the conversation
  • account: Teammate started the conversation
  • campaign: Triggered by a marketing campaign
  • workflow: Triggered by an automation workflow

handling_type - How the conversation is being handled:

  • none: No handler assigned yet
  • full_human: Handled entirely by human agents
  • full_ai: Handled entirely by Aura AI assistant
  • mixed_human_ai: Combination of AI and human handling

assigner.type - Type of assignment:

  • account: Assigned to a specific teammate
  • team: Assigned to a team inbox

last_message.sender_type - Type of sender for the last message:

  • account: Message sent by a teammate
  • contact: Message sent by the contact
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
\d+

The conversation id

Responses

401

Authentication required

403

Permission denied

404

Conversation not found

422

The request is not valid

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json