Xsolla-logo
  • Documentação
  • Criar conta

Pesquisar usuáriosServer-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 do projeto Login da Conta de Distribuidor.

query Parameters
limit
required
integer

Número máximo de usuários retornados por vez.

offset
integer

Número dos elementos a partir dos quais a lista é gerada.

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

Desautorizado

404

Não encontrado

429

Pedidos demais

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": [
    ]
}