List Conversations

1.   / 
2. API   / 
3. Convarsation   / 
4. List

---

Description

wss conversation_list

The conversation_list request returns a list of conversation objects.

Request Parameters

Name	Type	Description
limit	number	Max number of objects
updated_at.gt	timestamp	Time reference point

Response Fields

Name	Type	Description
conversations	array[object]	Array of Conversation objects

Example

Request

{
  "request": {
    "conversation_list": {
      "limit": 67,
      "updated_at": {
        "gt": timestamp_in_ms
      }
    },
    "id": "RequestId"
  }
}

Response

{
  "response": {
    "id": "RequestId",
    "conversations": [
      {
        "_id": "507f1f77bcf86cd799439011",
        "name": "General",
        "type": "g",
        "description": "General discuss chat",
        "owner_id": "507f191e810c19729de860ea",
        "opponent_id": "507f191e810c19729de880ee",
        "last_message": {
          "_id" :"507f191e810c19729de860ea",
          "body": "Any news on the recent decision?",
          "from": "507f191e810c19729de880ee",
          "t": 15673838833
        },
        "unread_messages_count": 2,
        "created_at": "2025-08-13T05:51:44.733Z",
        "updated_at": "2025-08-13T05:51:44.733Z"
      }
    ]
  }
}

See Also

SAMA chat server API: Conversations When we developed our API, we followed three rules: fast, confidential, and scalable. Each of these rules has a powerful force when we choose which messenger you will use.

DataBase Records Collection of complete objects stored in the database.