v1

latestOpenAPI 3.1.02026-07-22115189303.8 KB
Conversations

List conversations

Query WhatsApp conversations with filters. Results are returned by latest activity first and use cursor pagination.

get/whatsapp/conversations

Query parameters

phone_number_idstring

Filter by WhatsApp phone number ID

phone_numberstring

Filter by contact phone number (partial match)

status'active' | 'ended'

Filter by conversation status

assigned_user_idstring uuid

Filter by active assignee user ID (must be a project member)

unassignedboolean

Filter conversations with no active assignment. Cannot be combined with assigned_user_id.

created_afterstring date-time

Filter conversations created after this timestamp

created_beforestring date-time

Filter conversations created before this timestamp

last_active_afterstring date-time

Filter conversations active after this timestamp

last_active_beforestring date-time

Filter conversations active before this timestamp

limitinteger

Maximum number of results per cursor-paginated page (default 20, max 100).

beforestring

Cursor for the previous page (Base64 encoded).

afterstring

Cursor for the next page (Base64 encoded).

Response

List of conversations