Xsolla-logo

ユーザーを検索Server-side

get/projects/{project_id}/users/search

Searches users by criteria. Returns results with pagination and ordering.

SecurityServer
Request
path Parameters
project_id
required
string <uuid>

パブリッシャーアカウントからのログインプロジェクトID。

query Parameters
limit
required
integer

一度に返されるユーザー数の最大値。

offset
integer

リストが生成される要素の数。

order_column
string
Enum: "username" "contact" "group" "activity" "nickname" "custom_id"
order_dir
string

Condition for sorting the list of users.

Enum: "asc" "desc"
user_groups
Array of integers

An array with user group IDs.

status
boolean

Shows whether the user is active or not.

search_query
string

A search query. Can be contact, phone, id, social-id, username, nickname, ot custom_id.

search_by
string

A search criteria.

Enum: "contact" "phone" "id" "social-id" "username" "nickname" "custom_id"
activity_from
string

Starting date for user activity in the YYYY-MM-DD format.

activity_to
string

Starting date for user activity in the YYYY-MM-DD format.

Responses
200

OK

401

未認証

404

見つかりません

429

リクエストの回数が多すぎます

Request samples
curl --request GET \
  --url 'https://login.xsolla.com/api/projects/{project_id}/users/search?limit=SOME_INTEGER_VALUE&offset=SOME_INTEGER_VALUE&order_column=SOME_STRING_VALUE&order_dir=SOME_STRING_VALUE&user_groups=SOME_ARRAY_VALUE&status=SOME_BOOLEAN_VALUE&search_query=SOME_STRING_VALUE&search_by=SOME_STRING_VALUE&activity_from=SOME_STRING_VALUE&activity_to=SOME_STRING_VALUE' \
  --header 'X-SERVER-AUTHORIZATION: YOUR_SERVER_TOKEN'
Response samples
application/json
{
  • "count": 0,
  • "next_after": 0,
  • "users": [
    ]
}