Skip to main content
GET
Get Agent Conversations
Returns conversations sorted by timestamp (newest first). Empty conversations without essential data are filtered out.
Use page and limit query parameters to paginate large conversation lists efficiently.

Query Parameters

Example Response

Response Fields

Each conversation in the array includes:

Lead Information

  • userName, userEmail, userPhone - Contact details
  • userAddress, userCompany, userWebsite - Additional information
  • notes - Internal notes about the lead
  • userProfilePic - Profile picture URL

Conversation Metadata

  • ID, userID - Identifiers
  • messagesNum - Message count
  • tags - Categorization tags
  • origin - Channel (e.g., “web-chat”, “whatsapp”)
  • Timestamps: ts, firstMessageTS, lastMessageTS

Authorizations

Authorization
string
header
required

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

Path Parameters

agentId
string
required

Query Parameters

page
number
default:1
limit
number
default:20

Response

Successful response

success
boolean
required
message
string
required
data
object[]
required