List conversations

Returns a paginated list of conversations belonging to the authenticated user’s assistants. Supports filtering by type, assistant, and date range.

Endpoint

GET /user/conversations

Query parameters

string

Filter by conversation type: test, widget, whatsapp, or api.

integer

Filter by assistant ID. Must belong to your account.

string

Filter conversations from this date. Format: YYYY-MM-DD.

string

Filter conversations up to this date. Format: YYYY-MM-DD.

integer

Number of conversations per page. Range: 1–100. Default: 15.

integer

Page number. Default: 1.

Response

array

Array of conversation objects.

Show Conversation properties

string

Unique UUID of the conversation.

string

UUID of the assistant handling the conversation.

string

Name of the assistant.

string

Conversation type: test, widget, whatsapp, or api.

integer

Total number of messages exchanged.

number

Total cost of the conversation in USD.

boolean

Whether AI responses are enabled for this conversation.

string

Timestamp when the conversation was created.

string

Timestamp when the conversation was last updated.

integer

Current page number.

integer

Items per page.

integer

Total matching conversations.

integer

Last page number.

Conversation types

Type	Description
`test`	Internal test conversations from the assistant testing interface. Free.
`widget`	Conversations from the web chat widget. Charged per user message.
`whatsapp`	WhatsApp Business conversations.
`api`	Conversations created via the API.

Example

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

const response = await fetch(
  'https://portal.intellixent.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

200 Response

{
  "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"
    }
  ],
  "per_page": 15,
  "total": 68,
  "last_page": 5
}

Overview

Assistants

Calls

Campaigns & Leads

Conversations

Messaging

Phone Numbers

Knowledge & Tools

Webhooks

Endpoint

Query parameters

Response

Conversation types

Example

​Endpoint

​Query parameters

​Response

​Conversation types

​Example

Endpoint

Query parameters

Response

Conversation types

Example