Skip to main content
GET
CLI
Pull the history when you need it: to build your own chat view, to catch up after your bot restarts, or to debug, without keeping a copy of every webhook event. Pass a chatId to List Conversation Messages to read one conversation.
Need email too, search, assignment or replies? Use the Inbox API.

Response shape

The list is in data.data and the pages in data.pagination (totalRecords, currentPage, totalPages, nextPage, prevPage). pageSize is at most 100.

Permissions

The API key needs the WhatsApp permission. Every call is scoped to the key’s workspace.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1
pageSize
integer
default:20

Up to 100.

Required range: x <= 100

Response

Conversations

data
object