Query Group Member Mute List

Retrieve the list of users muted in a specified group, returning their user IDs.

If no group is specified (groupId is empty), the list of muted users from all groups will be retrieved.

Request Method

POST: https://Data Center Domain/group/user/gag/list.json

Signature Rule: All server API requests must undergo rule validation. For details, see API Request Signature.

Rate Limit: 100 requests per second

Body Parameters

The HTTP request body may include the following HTTP form parameters:

Parameter	Type	Required	Description
groupId	String	No	Group ID. If empty, retrieves muted users from all groups.

Request Example

POST /group/user/gag/list.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

groupId=16

Response

The HTTP response body contains a JSON object with the following structure:

Return Value	Return Type	Description
code	Number	Return code, 200 indicates success.
users	Array of objects	List of muted members.
users[i].startTime	String	Mute start time. Accurate to the second, in the format YYYY-MM-DD HH:MM:SS, e.g., 2022-09-25 16:12:38. Note: The value of time is related to the data center of the app. If your app uses the China (Beijing) Data Center, time is in Beijing time. If your app uses the global data center, time is in UTC time.
users[i].time	String	Unmute time. Accurate to the second, in the format YYYY-MM-DD HH:MM:SS, e.g., 2022-09-25 16:12:38. Note: The value of time is related to the data center of the app. If your app uses the China (Beijing) Data Center, time is in Beijing time. If your app uses the global data center, time is in UTC time.
users[i].userId	String	User ID of the group member.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 200,
  "users": [
    {
      "startTime": "2024-02-07 18:25:12",
      "time": "2024-02-07 18:55:12",
      "userId": "u02"
    },
    {
      "startTime": "2024-02-07 18:25:12",
      "time": "2024-02-07 18:55:12",
      "userId": "u01"
    }
  ]
}