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"

resolutionVerdict
enum<string>[]

Filter by the post-close resolution verdict: whether the customer's issue actually ended up solved. Comma-separated for several values (?resolutionVerdict=RESOLVED,UNRESOLVED); an unknown value returns 400. Requires the resolution analysis add-on. Conversations without a verdict (still open, reopened, or not yet analysed) are excluded.

Available options:
RESOLVED,
UNRESOLVED
handledBy
enum<string>[]

Filter by who actually carried the conversation to its end. NONE means nobody meaningfully engaged - for example the customer asked for a human and none ever replied. This is not the same as resolutionStatus=TalkToAgent, which only means a human was requested. Comma-separated for several values (?handledBy=AI,NONE); an unknown value returns 400. Requires the resolution analysis add-on.

Available options:
AI,
HUMAN_AGENT,
NONE
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