Skip to main content
GET
List conversations for a contact

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

contactId
string
required

Unique identifier of the contact

Example:

"contact_1234567890"

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
Example:

1

perPage
integer
default:20

Number of records per page (max 100)

Required range: 1 <= x <= 100
Example:

20

sort
enum<string>
default:desc

Sort order for lastMessageDate

Available options:
asc,
desc
Example:

"desc"

status
enum<string>

Filter by conversation status

Available options:
open,
close
Example:

"open"

startDate
string

Filter by start date. Supports Unix timestamp in seconds (e.g., 1747196400) or ISO 8601 format (e.g., 2024-01-01)

Example:

"2024-01-01"

endDate
string

Filter by end date. Supports Unix timestamp in seconds (e.g., 1747200000) or ISO 8601 format (e.g., 2024-01-31)

Example:

"2024-01-31"

assignedTo
string

Filter by assigned agent ID. Use 'ai' for AI-handled conversations (no human agent assigned)

Example:

"user_1234567890"

sentiment
enum<string>

Filter by conversation sentiment

Available options:
POSITIVE,
NEGATIVE,
NEUTRAL,
UNSPECIFIED
Example:

"POSITIVE"

topic
string

Filter by conversation topic name

Example:

"billing"

channel
enum<string>

Filter by conversation channel (integration type or chat type)

Available options:
WHATSAPP,
SLACK,
MESSENGER,
FULLPAGE,
INLINECHAT,
PREVIEW,
ONBOARDING
Example:

"WHATSAPP"

resolutionStatus
enum<string>

Filter by resolution status

Available options:
AIHelped,
AIDidNotHelp,
TalkToAgent
Example:

"AIHelped"

viewId
string

Filter using a saved inbox view ID. When provided, applies all filters configured in the inbox view. Other filters can be combined with viewId

Example:

"view_1234567890"

Response

Successfully retrieved conversations list for the contact

status
string
Example:

"success"

data
object