Skip to main content
GET
/
api
/
public
/
v1
/
replies
List conversations
curl --request GET \
  --url https://api.coldsend.pro/api/public/v1/replies \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "threads": [
    {
      "thread_id": "<string>",
      "lead_email": "<string>",
      "lead_name": "<string>",
      "campaign_name": "<string>",
      "subject": "<string>",
      "last_message_preview": "<string>",
      "last_message_at": "2023-11-07T05:31:56Z",
      "is_read": true,
      "is_starred": true,
      "reply_count": 123,
      "lead_id": "<string>",
      "inbox_id": "<string>",
      "category": "<string>"
    }
  ],
  "total_count": 123,
  "page": 123,
  "limit": 123,
  "total_pages": 123,
  "has_next": true,
  "has_prev": true,
  "unread_count": 123,
  "starred_count": 123
}

Authorizations

X-API-Key
string
header
required

API key with format cs_live_xxx

Query Parameters

campaign_id
string<uuid> | null

Filter by campaign ID

status
string | null

Filter by status: unread, read, starred

search
string | null

Search by lead name, email, or subject

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:50

Items per page

Required range: 1 <= x <= 200

Response

Conversations retrieved

Paginated list of conversation threads.

success
boolean
required
message
string
required
threads
PublicThreadItem · object[]
required

List of conversation threads

total_count
integer
required

Total matching threads

page
integer
required

Current page

limit
integer
required

Items per page

total_pages
integer
required

Total pages

has_next
boolean
required

Whether more pages exist

has_prev
boolean
required

Whether a previous page exists

unread_count
integer
required

Number of unread threads in the current result set

starred_count
integer
required

Number of starred threads in the current result set