Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://api.example.com/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "68505cb92a11ea971d9df894",
      "createdAt": "2025-11-27T00:00:00.000Z",
      "updatedAt": "2025-11-27T16:00:00.000Z",
      "channel": "whatsapp",
      "fullName": "Sofia Martinez",
      "phoneNumber": "+524441234567",
      "summary": "Guest asked about late checkout and breakfast options.",
      "intent": "booking_inquiry"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 25,
      "nextCursor": "68505cb92a11ea971d9df894",
      "hasMore": true
    }
  }
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <api_key>.

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"

sortBy
enum<string>

Sort conversations by creation date or last update date.

Available options:
createdAt,
updatedAt
Example:

"updatedAt"

channel
enum<string>

Filter by conversation channel.

Available options:
whatsapp,
messenger,
instagram,
airbnb,
voice,
webchat,
playground
Example:

"whatsapp"

intent
string

Filter by intent key.

Example:

"booking_inquiry"

q
string

Search text across contact full name, phone number, and summary preview.

Example:

"late checkout"

Response

200 - application/json

A list of available conversations

data
object[]
required

List of conversations.

meta
object
required