Xsolla-logo
  • Documentación
  • Crear cuenta

Buscar usuariosServer-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 del proyecto de Login procedente de Cuenta del editor.

query Parameters
limit
required
integer

Número máximo de usuarios que se devuelven simultáneamente.

offset
integer

Número de los elementos a partir de los cuales se genera la lista.

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

ACEPTAR

401

Unauthorized (No autorizado)

404

Not Found (No encontrado)

429

Too Many Requests (Demasiadas solicitudes)

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