Search users by extended filter

GET /api/2.0/people/simple/filter

Request

Returns a list of users matching the parameters specified in the request.

Authorization

An API key is a token that you provide when making API calls. Include the token in a cookie parameter called asc_auth_key.

Example: asc_auth_key=864FE52C-1C1C-469F-9308-51DAFEFE7436.

Headers

Acceptenum of string

Can be one of: application/json, text/json, text/plain.

Query

employeeStatusone of

User status

.enum of string

[Active - Active, Terminated - Terminated, Pending - Pending, Default - Default, All - All]

Can be one of: Active, Terminated, Pending, Default, All.

.enum of integer

[1 - Active, 2 - Terminated, 4 - Pending, 5 - Default, 7 - All]

Can be one of: 1, 2, 4, 5, 7.

groupIdstringformat: uuid

Group ID

activationStatusone of

Activation status

.enum of string

[NotActivated - Not activated, Activated - Activated, Pending - Pending, AutoGenerated - Auto generated]

Can be one of: NotActivated, Activated, Pending, AutoGenerated.

.enum of integer

[0 - Not activated, 1 - Activated, 2 - Pending, 4 - Auto generated]

Can be one of: 0, 1, 2, 4.

employeeTypeone of

User type

.enum of string

[All - All, RoomAdmin - Room admin, Guest - Guest, DocSpaceAdmin - DocSpace admin, User - User]

Can be one of: All, RoomAdmin, Guest, DocSpaceAdmin, User.

.enum of integer

[0 - All, 1 - Room admin, 2 - Guest, 3 - DocSpace admin, 4 - User]

Can be one of: 0, 1, 2, 3, 4.

employeeTypesarray of any of

List of user types

.enum of string

[All - All, RoomAdmin - Room admin, Guest - Guest, DocSpaceAdmin - DocSpace admin, User - User]

Can be one of: All, RoomAdmin, Guest, DocSpaceAdmin, User.

.enum of integer

[0 - All, 1 - Room admin, 2 - Guest, 3 - DocSpace admin, 4 - User]

Can be one of: 0, 1, 2, 3, 4.

isAdministratorboolean

Specifies if the user is an administrator or not

paymentsone of

User payment status

.enum of string

[Paid - Paid, Free - Free]

Can be one of: Paid, Free.

.enum of integer

[0 - Paid, 1 - Free]

Can be one of: 0, 1.

accountLoginTypeone of

Account login type

.enum of string

[SSO - SSO, LDAP - LDAP, Standart - Standart]

Can be one of: SSO, LDAP, Standart.

.enum of integer

[0 - SSO, 1 - LDAP, 2 - Standart]

Can be one of: 0, 1, 2.

quotaFilterone of

Filter by quota (Default - 1, Custom - 2)

.enum of string

[All - All, Default - Default, Custom - Custom]

Can be one of: All, Default, Custom.

.enum of integer

[0 - All, 1 - Default, 2 - Custom]

Can be one of: 0, 1, 2.

withoutGroupboolean

Specifies whether the user should be a member of a group or not

excludeGroupboolean

Specifies whether or not the user should be a member of the group with the specified ID

invitedByMeboolean

Invited by me

inviterIdstringformat: uuid

Inviter Id

areaenum of integerformat: int32

Area

Can be one of: 0, 1, 2.

Examples

GET /api/2.0/people/simple/filter?groupId=75a5f745-f697-4418-b38d-0fe0d277e258&isAdministrator=true&withoutGroup=true&excludeGroup=true&invitedByMe=true&inviterId=75a5f745-f697-4418-b38d-0fe0d277e258&area=0 HTTP/1.1
Accept: application/json
Host: example.com

curl --request GET \
  --url 'https://example.com/api/2.0/people/simple/filter?groupId=75a5f745-f697-4418-b38d-0fe0d277e258&isAdministrator=true&withoutGroup=true&excludeGroup=true&invitedByMe=true&inviterId=75a5f745-f697-4418-b38d-0fe0d277e258&area=0' \
  --header 'Accept: application/json'

Responses

200

List of users

idstringformat: uuid

ID

displayNamestring

Display name

titlestring

Title

avatarstring

Avatar

avatarOriginalstring

Original size avatar

avatarMaxstring

Maximum size avatar

avatarMediumstring

Medium size avatar

avatarSmallstring

Small avatar

profileUrlstring

Profile URL

hasAvatarboolean

Specifies if the user has an avatar or not

isAnonimboolean

Specifies if the user is an anonim or not

401

Unauthorized

403

No permissions to perform this action