Conversations
List Conversations
List all conversations for the authenticated user with filtering and pagination
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, apiinteger
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

