Get Conversation

Retrieve the message history of a conversation

Updated 25 Jan 2026

On this page

This endpoint retrieves the complete message history of an existing conversation. Use this to display previous messages when resuming a conversation or to review conversation content.

Path Parameters

uuidstringrequired

The unique UUID identifier of the conversation to retrieve

Response Fields

statusboolean

Indicates whether the request was successful

historyarray

Array of messages in the conversation, ordered chronologically (oldest first).

rolestring

  The message role: `assistant` or `user`

contentstring

  The message content

function_callsarray

  Optional. Array of function calls made by the assistant during this message (e.g., calendar bookings, API calls).

Error Responses

statusboolean

Will be false when an error occurs

errorstring

Error message. Possible values:

Conversation not found - The provided UUID does not match any conversation

curl -X GET "https://app.voxlink.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"

const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';

const response = await fetch(
  `https://app.voxlink.ai/api/conversations/${conversationId}`
);

const data = await response.json();
console.log(data.history);

import requests

conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'

response = requests.get(
    f'https://app.voxlink.ai/api/conversations/{conversation_id}'
)

data = response.json()
print(data['history'])

{
  "status": true,
  "history": [
    {
      "role": "assistant",
      "content": "Hello! Welcome to our support. How can I help you today?"
    },
    {
      "role": "user",
      "content": "I'd like to schedule a demo"
    },
    {
      "role": "assistant",
      "content": "I'd be happy to help you schedule a demo! I have availability tomorrow at 2 PM or Thursday at 10 AM. Which works better for you?",
      "function_calls": [
        {
          "name": "check_calendar_availability",
          "arguments": {
            "date_range": "next_7_days"
          },
          "result": {
            "available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
          }
        }
      ]
    },
    {
      "role": "user",
      "content": "Thursday at 10 AM works for me"
    },
    {
      "role": "assistant",
      "content": "I've scheduled your demo for Thursday, January 12th at 10 AM. You'll receive a calendar invitation shortly. Is there anything specific you'd like us to cover during the demo?",
      "function_calls": [
        {
          "name": "book_appointment",
          "arguments": {
            "datetime": "2025-01-12T10:00:00",
            "title": "Product Demo"
          },
          "result": {
            "success": true,
            "booking_id": "abc123"
          }
        }
      ]
    }
  ]
}

{
  "status": false,
  "error": "Conversation not found"
}

Use Cases

Resume conversations: Retrieve history when a user returns to continue a conversation
Analytics: Review conversation content for quality assurance
Integration: Sync conversation data with your CRM or support system

Related guides

Conversations & Call Records

Conversations Overview

Track and review text-based conversations with your AI assistant

Read guide →

Conversations & Call Records

Viewing & Managing Conversations

How to view, filter, and manage your conversation history

Read guide →

Conversations & Call Records

List Conversations

List all conversations for the authenticated user with filtering and pagination

Read guide →

Conversations & Call Records

Create Conversation

Create a new conversation session with an AI assistant

Read guide →