Skip to main content
GET
This endpoint returns a cursor-paginated list of conversations belonging to the authenticated user’s assistants. Use it to view conversation history, filter by type, or integrate with your CRM.
This endpoint uses cursor-based pagination for better performance with large datasets. Use next_cursor and prev_cursor to navigate between pages.

Query Parameters

string
Filters conversations by type. Possible values: test, widget, whatsapp, api
integer
Filters conversations by assistant ID (must belong to the authenticated user)
string
Filters conversations by the customer’s phone number (exact match). Useful for finding all conversations with a specific customer.
string
Filters conversations by WhatsApp sender phone number (exact match). Useful for finding all conversations from a specific WhatsApp Business number.
string
Filters conversations by an external identifier. Useful for finding conversations linked to records in your external system.
integer
Number of conversations per page (1-100, default: 15)
string
Cursor for pagination. Use next_cursor or prev_cursor from a previous response.

Response Fields

array
string
Cursor to fetch the next page of results. Pass this as the cursor parameter in your next request. null if there are no further results.
string
Cursor to fetch the previous page of results. null if this is the first page.
integer
Number of items per page

Conversation Types

Filter Parameters

All filter parameters use indexed columns for efficient querying:

WhatsApp Conversation Details

For WhatsApp conversations, the response includes additional fields:
  • whatsapp_sender: The WhatsApp Business number that conducted the conversation (name and phone number of your WhatsApp sender)
  • customer: The customer who initiated or received the conversation (their name and phone number)
These fields are only present for conversations of type whatsapp and help identify the parties involved when integrating with your CRM or support systems.

API Conversation Details

For conversations created via the API, you can set an external_identifier when creating the conversation. This identifier is returned in the response and can be used for:
  • Linking conversations with your CRM leads or contacts
  • Tracking conversations across your internal systems
  • Filtering conversations by your external reference

Use Cases

  • Analytics Dashboard: Display conversation metrics and trends
  • CRM Integration: Sync conversation data with your customer database using external_identifier
  • Customer Lookup: Find all conversations with a particular customer via customer_phone
  • Quality Monitoring: Review conversation volume by type and assistant
  • Billing Audit: Track conversation costs within your organization