List Conversations

List all conversations for the authenticated user with filtering and pagination

Updated 25 Jan 2026

On this page

This endpoint returns a paginated list of conversations belonging to the authenticated user's assistants. Use this to display conversation history, filter by type, or integrate with your CRM.

This endpoint requires authentication. Pass your API key in the Authorization header as a Bearer token.

Query Parameters

typestring

Filter conversations by type. Possible values: test, widget, whatsapp, api

assistant_idinteger

Filter conversations by assistant ID (must belong to the authenticated user)

date_fromstring

Filter conversations from this date (YYYY-MM-DD format)

date_tostring

Filter conversations until this date (YYYY-MM-DD format)

per_pageinteger

Number of conversations per page (1-100, default: 15)

pageinteger

Page number (default: 1)

Response Fields

dataarray

idstring

  The unique UUID identifier of the conversation

assistant_idstring

  The UUID of the assistant handling this conversation

assistant_namestring

  The name of the assistant handling this conversation

typestring

  The conversation type: `test`, `widget`, `whatsapp`, or `api`

message_countinteger

  Total number of messages in the conversation

total_costnumber

  The total cost of the conversation in USD

ai_enabledboolean

  Whether AI responses are enabled for this conversation

created_atstring

  The date and time when the conversation was created

updated_atstring

  The date and time when the conversation was last updated

current_pageinteger

The current page number

per_pageinteger

Number of items per page

totalinteger

Total number of conversations matching the criteria

last_pageinteger

The last page number

curl -X GET "https://app.voxlink.ai/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://app.voxlink.ai/api/user/conversations?type=widget&per_page=10',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.data); // Array of conversations

import requests

response = requests.get(
    'https://app.voxlink.ai/api/user/conversations',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
        'type': 'widget',
        'per_page': 10
    }
)

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

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.voxlink.ai/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.voxlink.ai/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://app.voxlink.ai/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.voxlink.ai/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.voxlink.ai/api/user/conversations?page=2",
  "path": "https://app.voxlink.ai/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

Conversation Types

Type	Description
`test`	Internal test conversations from the assistant testing interface
`widget`	Conversations from the web chat widget
`whatsapp`	WhatsApp Business conversations
`api`	Conversations created via the API