> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intellixent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List conversations

> Retrieve a paginated list of chat 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

<ParamField query="type" type="string">
  Filter by conversation type: `test`, `widget`, `whatsapp`, or `api`.
</ParamField>

<ParamField query="assistant_id" type="integer">
  Filter by assistant ID. Must belong to your account.
</ParamField>

<ParamField query="date_from" type="string">
  Filter conversations from this date. Format: `YYYY-MM-DD`.
</ParamField>

<ParamField query="date_to" type="string">
  Filter conversations up to this date. Format: `YYYY-MM-DD`.
</ParamField>

<ParamField query="per_page" type="integer">
  Number of conversations per page. Range: 1–100. Default: `15`.
</ParamField>

<ParamField query="page" type="integer">
  Page number. Default: `1`.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of conversation objects.

  <Expandable title="Conversation properties">
    <ResponseField name="id" type="string">Unique UUID of the conversation.</ResponseField>
    <ResponseField name="assistant_id" type="string">UUID of the assistant handling the conversation.</ResponseField>
    <ResponseField name="assistant_name" type="string">Name of the assistant.</ResponseField>
    <ResponseField name="type" type="string">Conversation type: `test`, `widget`, `whatsapp`, or `api`.</ResponseField>
    <ResponseField name="message_count" type="integer">Total number of messages exchanged.</ResponseField>
    <ResponseField name="total_cost" type="number">Total cost of the conversation in USD.</ResponseField>
    <ResponseField name="ai_enabled" type="boolean">Whether AI responses are enabled for this conversation.</ResponseField>
    <ResponseField name="created_at" type="string">Timestamp when the conversation was created.</ResponseField>
    <ResponseField name="updated_at" type="string">Timestamp when the conversation was last updated.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="current_page" type="integer">Current page number.</ResponseField>
<ResponseField name="per_page" type="integer">Items per page.</ResponseField>
<ResponseField name="total" type="integer">Total matching conversations.</ResponseField>
<ResponseField name="last_page" type="integer">Last page number.</ResponseField>

## 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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://portal.intellixent.ai/api/user/conversations?type=widget&per_page=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  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
  ```
</CodeGroup>

```json 200 Response theme={null}
{
  "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
}
```