Skip to content

List Messages

Description

wss message_list

The message_list request returns a list of message objects for the specified query.

Request Parameters

Name	Type	Description
`cid`	`string`	Conversation ID where to search
`ids`	`array[string]`	Array of IDs for the necessary messages
`limit`	`number`	Max number of returned messages
`updated_at.gt`	`date`	Time point of search
`updated_at.lt`	`date`	Time point of search

Response Fields

Name	Type	Description
`messages`	`array`	Array of Message objects

Examples

Request

{
  "request": {
    "message_list": {
      "cid": "63077ad836b78c3d82af0812",
      "limit": 27,
      "updated_at": {
        "gt": timestamp_in_ms
      }
    },
    "id": "RequestId"
  }
}

Response

{
  "response": {
    "id": "RequestId",
    "messages": [
      {
        _id: "63760c34c35e750877677925",
        body: "How is going?",
        cid: "63563a2ad745dc1c6ad01b5f",
        from: "63480e68f4794709f802a2fa",
        status: "sent",
        attachments: [
          { file_id: "file_name_1", file_name: "file_1" }
        ],
        reactions: {}
        t: 1668680757,
        created_at: "2023-05-24T14:34:58.066Z"
      }
    ]
  }
}

Response

{
  "request": {
    "message_list": {
      "cid": "63077ad836b78c3d82af0812",
      "ids": [ "63760c34c35e750877677925", ... ]
    },
    "id": "RequestId"
  }
}

Response

{
  "response": {
    "id": "RequestId",
    "messages": [
      {
        "_id": "63760c34c35e750877677925",
        "body": "How is going?",
        "cid": "63563a2ad745dc1c6ad01b5f",
        "from": "63480e68f4794709f802a2fa",
        "status": "sent",
        "attachments": [
          { "file_id": "file_name_1", "file_name": "file_1" }
        ],
        "reactions": {}
        "t": 1668680757,
        "created_at": "2025-08-13T05:51:44.733Z"
      },
      ...
    ]
  }
}

See Also

SAMA chat server API: Messages Based on ease of use, and with easy-to-understand documentation and articles on how to set up and use our APIs, we want to show that it is REAL to build communication into your application.

DataBase Records Collection of complete objects stored in the database.