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

# GET List Conversations

> Retrieve all conversations with filtering and pagination.

## List Conversations

`GET /api/conversations`

Retrieve a paginated list of conversations for the authenticated user.

### Headers

**x-api-key** `string` *required*

Your API key

**x-api-secret** `string` *required*

Your API secret key

**x-channel-id** `string` *required*

WhatsApp channel ID

```bash cURL theme={null}
curl "https://zeplo.ai/api/conversations?status=open&limit=20" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-api-secret: YOUR_API_SECRET" \
  -H "x-channel-id: YOUR_CHANNEL_ID"
```

### Query parameters

**page** `integer` (default: 1)

Page number for pagination.

**limit** `integer` (default: 20)

Items per page.

**status** `string`

Filter by status: `open`, `resolved`, `closed`.

**assignedTo** `integer`

Filter by assigned team member.

**channelId** `integer`

Filter by channel.

**search** `string`

Search contact name or phone.

**sortBy** `string` (default: lastMessageAt)

Sort field.

**sortOrder** `string` (default: desc)

`asc` or `desc`.

```json Response theme={null}
{
  "success": true,
  "data": [
    {
      "id": 1,
      "channelId": "647015955153740",
      "contactId": 5,
      "contactName": "John Doe",
      "contactPhone": "919876543210",
      "status": "open",
      "assignedTo": 2,
      "assignedToName": "Agent Smith",
      "lastMessage": "Hello, I need help",
      "lastMessageAt": "2026-01-15T10:30:00Z",
      "unreadCount": 3,
      "tags": ["support", "billing"],
      "createdAt": "2026-01-14T08:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "totalPages": 3
  }
}
```

***

## Get unread count

`GET /api/conversations/unread-count`

Retrieve the total number of unread conversations.

```bash cURL theme={null}
curl https://zeplo.ai/api/conversations/unread-count \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-api-secret: YOUR_API_SECRET" \
  -H "x-channel-id: YOUR_CHANNEL_ID"
```

```json Response theme={null}
{
  "success": true,
  "count": 12
}
```


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