Filtering Users

This step shows how to filter users

Important Note! Constructor Groups’ V1 API has been retired and is no longer available to new customers. Please use the Groups V2 API going forward. Link to V2 API documentation: https://developer.perculus.com/v2-en

Available parameters:

Parameter	Type	Description
name	string	Name of the user
surname	string	Surname of the user
email	string	Email of the user
username	string	Username of the user
user_id	string	GUID of the user
role	string	Role of the user (see)
mobile	string	Mobile of the user
page_size	integer	Page size
page_number	integer	Page number

If you like to see all users belonging to your account, you can achieve this by not sending any parameters to the request.

Example request:

CURL

curl --location --request GET 'https://<DOMAIN>/xapi/user' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: x-www-form-urlencoded' \
--data-urlencode 'name=john' \
--data-urlencode 'username=doe'

Python

from perculus_sdk.client import APIClient

# API client
client = APIClient()
...

# Search user 
user = client.users.search_user({
    "name": "<USER_NAME>",
    "surname": "<USER_SURNAME>"
})
print(user)

C#

// ASAP :)

NodeJS

import APIClient from "perculus-sdk"

// API client
const client = new APIClient()
...

// Search users 
const users = client.users.searchUsers({
    name: "<USER_NAME>",
    surname: "<USER_SURNAME>"
})
console.log(users)

Go

// ASAP :)

Example response:

[
    {
        "user_id": "<USER_ID>",
        "name": "john",
        "surname": "Doe",
        "username": "johndoe",
        "email": "[e-mail]",
        "role": "u",
        "mobile": "",
        "login_allowed": true,
        "status": 1,
        "lang": "tr-TR",
        "timezone": null,
        "expires_at": null,
        "creation_date": "2024-08-01T00:45:03.8888474+00:00",
        "updating_date": null
    }
]