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

# List Conversations

> List all conversations for the authenticated user with filtering and pagination

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.

> [!NOTE]
>
> This endpoint requires authentication. Pass your API key in the `Authorization` header as a Bearer token.

### Query Parameters

**type** `string`

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

**assistant\_id** `integer`

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

**date\_from** `string`

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

**date\_to** `string`

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

**per\_page** `integer`

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

**page** `integer`

Page number (default: 1)

### Response Fields

**data** `array`

**properties**

**id** `string`

The unique UUID identifier of the conversation

**assistant\_id** `string`

The UUID of the assistant handling this conversation

**assistant\_name** `string`

The name of the assistant handling this conversation

**type** `string`

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

**message\_count** `integer`

Total number of messages in the conversation

**total\_cost** `number`

The total cost of the conversation in USD

**ai\_enabled** `boolean`

Whether AI responses are enabled for this conversation

**created\_at** `string`

The date and time when the conversation was created

**updated\_at** `string`

The date and time when the conversation was last updated

**current\_page** `integer`

The current page number

**per\_page** `integer`

Number of items per page

**total** `integer`

Total number of conversations matching the criteria

**last\_page** `integer`

The last page number

```bash cURL theme={null}
curl -X GET "https://app.receptonic.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://app.receptonic.com/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
```

```python Python theme={null}
import requests

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

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

```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"
    },
    {
      "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.receptonic.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.receptonic.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.receptonic.com/api/user/conversations?page=2",
  "path": "https://app.receptonic.com/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 |

## Use Cases

* **Analytics Dashboard**: Display conversation metrics and trends
* **CRM Integration**: Sync conversation data with your customer database
* **Quality Monitoring**: Review conversation volumes by type and assistant
* **Billing Review**: Track conversation costs across your organization


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.