List conversations

Returns conversations across your robots, most recently active first.

Filter by robot_id, channel_id or status. Filtering on status=operator_attention is how you build a queue of conversations waiting for a human.

Authentication

AuthorizationBearer

Your API key, issued by ParsChat sales. One key per account, spanning every robot you own. Send it as Authorization: Bearer pk_live_….

Query parameters

robot_idstringOptional
Only conversations on this robot.
channel_idstringOptional
Only conversations on this channel.
statusenumOptional
Only conversations in this state.
Allowed values:
limitintegerOptional1-100Defaults to 50
How many items to return per page.
offsetintegerOptional>=0Defaults to 0

How many records to skip. Use offset = page * limit, and total_count from the response to know when to stop.

Response

A page of conversations.
datalist of objectsOptional
paginationobjectOptional

Offset pagination. total_count tells you how many records match, so you know how many pages to fetch before you start.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error