Skip to main content

Overview

Query the list of banned users. Pagination is supported.

Request

Authentication: Add authentication headers to the request. See Authentication.

Method: GET

Rate limit: 100 requests/second

Endpoint: https://API domain/apigateway/users/banusers/query

Content-Type: application/json

Request Parameters

ParameterData TypeRequiredDescription
limitintNoNumber of records per page. Default: 50. Maximum: 100.
offsetstringNoPagination offset.

Request Example

GET /apigateway/users/banusers/query?limit=20&offset="" HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
Content-Type: application/json

Response Parameters

ParameterData TypeDescription
itemsarrayList of banned users.
items[].user_idstringBanned user ID.
items[].created_timenumberTime when the ban was added.
items[].end_timenumberBan expiration time in milliseconds. A value of 0 indicates a permanent ban.
offsetstringOffset for the next page.

Response Example

{
"code":0,
"msg":"sucess",
"data":{
"items":[
{
"user_id":"user1",
"created_time":1672233498000
},
{
"user_id":"user2",
"created_time":1672233498000,
"end_time":1723455443563
}
],
"offset":"aabbcc"
}
}