Skip to main content
GET
List conversations

Authorizations

Authorization
string
header
required

Your workspace API key, created in Settings → API keys, sent as Authorization: Bearer <key>. New keys start with watx_live_; keys issued before the rename start with converse360_live_ and still work.

Query Parameters

limit
integer
default:50

Page size. Default 50, maximum 100. An unusable value falls back to 50.

Required range: 1 <= x <= 100
cursor
string

The meta.next_cursor from the previous page, passed back verbatim. An unreadable cursor is ignored and the first page is returned.

status
enum<string>

Filter by conversation status.

Available options:
open,
pending,
closed
contact_id
string<uuid>

Only this contact's conversations.

channel
enum<string>

Only conversations on this channel. An unknown value is a 400.

Available options:
whatsapp,
instagram,
web

Response

A page of conversations.

data
object[]
meta
object

Pagination metadata on list responses.