Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://api.example.com/conversations
{
  "data": [
    {
      "id": "68505cb92a11ea971d9df894",
      "createdAt": "2025-11-27T00:00:00.000Z",
      "updatedAt": "2025-11-27T16:00:00.000Z",
      "channel": "whatsapp",
      "fullName": "Sofia Martinez",
      "phoneNumber": "+524441234567"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 25,
      "nextCursor": "eyJpZCI6IjY4NTA1Y2I5MmExMWVhOTcxZDlkZjg5NCJ9",
      "hasNextPage": true
    }
  }
}

Query Parameters

limit
integer

Max number of conversations to return (1–100).

Required range: 1 <= x <= 100
Example:

25

cursor
string

Pagination cursor returned by the previous request. Pass it to fetch the next page.

Example:

"eyJpZCI6IjY4NTA1Y2I5MmExMWVhOTcxZDlkZjg5NCJ9"

Response

200 - application/json

A list of available conversations

data
object[]
required

List of conversations.

meta
object
required