Skip to main content
GET
/
api
/
v1
/
conversations
List Conversations
curl --request GET \
  --url https://api.sequenzy.com/api/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}
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

​
status
string
Filter by status: all, open, or closed. Defaults to all.
​
search
string
Search in subject, subscriber email, or subscriber name.
​
page
number
Page number. Defaults to 1.
​
limit
number
Results per page, from 1 to 100. Defaults to 20.
​
unread
string
Pass true to only return conversations with unread messages.
curl "https://api.sequenzy.com/api/v1/conversations?status=open&unread=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Responses

{
  "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
  }
}