Skip to main content
GET
This endpoint returns a paginated list of conversations belonging to the authenticated user’s assistants. Use this to display conversation history, filter by type, or integrate with your CRM.
This endpoint requires authentication. Pass your API key in the Authorization header as a Bearer token.

Query Parameters

string
Filter conversations by type. Possible values: test, widget, whatsapp, api
integer
Filter conversations by assistant ID (must belong to the authenticated user)
string
Filter conversations from this date (YYYY-MM-DD format)
string
Filter conversations until this date (YYYY-MM-DD format)
integer
Number of conversations per page (1-100, default: 15)
integer
Page number (default: 1)

Response Fields

array
integer
The current page number
integer
Number of items per page
integer
Total number of conversations matching the criteria
integer
The last page number

Conversation Types

Use Cases

  • Analytics Dashboard: Display conversation metrics and trends
  • CRM Integration: Sync conversation data with your customer database
  • Quality Monitoring: Review conversation volumes by type and assistant
  • Billing Review: Track conversation costs across your organization