Skip to main content
GET
List conversations

Authorizations

Authorization
string
header
required

An org API key: Authorization: Bearer oak_….

Query Parameters

limit
integer
default:30
Required range: 1 <= x <= 100
cursor
string | null
status
enum<string>[] | null

Lifecycle of a conversation. resolved is terminal: the contact's next message opens a fresh conversation. There is no expired value: WhatsApp 24h "expiry" is a derived window state (now - last_inbound_at >= 24h), not a lifecycle status — an expired thread is still open. (closed was dropped by migration 0200: nothing distinguished it from resolved.)

Available options:
open,
resolved
contact_id
string | null
assignee_id
string[] | null

Response

Successful Response

items
PublicConversation · object[]
required
next_cursor
string | null
required