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

# List Conversations

> List inbox conversations

List inbox conversations created from subscriber replies. Results are sorted by most recent message and can be filtered by status, unread flag, or a search term.

## Request

<ParamField query="status" type="string">
  Filter by status: `all`, `open`, or `closed`. Defaults to `all`.
</ParamField>

<ParamField query="search" type="string">
  Search in subject, subscriber email, or subscriber name.
</ParamField>

<ParamField query="page" type="number">
  Page number. Defaults to 1.
</ParamField>

<ParamField query="limit" type="number">
  Results per page, from 1 to 100. Defaults to 20.
</ParamField>

<ParamField query="unread" type="string">
  Pass `true` to only return conversations with unread messages.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/conversations?status=open&unread=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "conversations": [
      {
        "id": "conv_abc123",
        "subscriberId": "sub_abc123",
        "subscriberEmail": "user@example.com",
        "subscriberName": "John Doe",
        "subject": "Re: A quick update",
        "status": "open",
        "messageCount": 3,
        "lastMessageAt": "2026-06-11T09:30:00.000Z",
        "lastMessageBy": "subscriber",
        "hasUnread": true,
        "createdAt": "2026-06-10T15:00:00.000Z",
        "context": {
          "type": "campaign",
          "label": "April Launch"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Invalid status filter"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```
</ResponseExample>