Get Started
Usage API
More information

GET api/2.0/people/filter This function requires authentication

Description

Returns a list of users with full information about them matching the parameters specified in the request.

Parameters
Name Description Type Example
employeeStatus
sent in url
User status
optional
ASC.Core.Users.EmployeeStatus
groupId
sent in url
Group ID
optional
guid 9924256A-739C-462b-AF15-E652A3B1B6EB
activationStatus
sent in url
Activation status
optional
ASC.Core.Users.EmployeeActivationStatus
employeeType
sent in url
User type
optional
ASC.Core.Users.EmployeeType
isAdministrator
sent in url
Specifies if the user is administrator or not
optional
Bool value true
Example
GET api/2.0/people/filter
Host: yourportal.onlyoffice.com
Content-Type: application/json
Accept: application/json
Returns

List of users with their information

Example Response

application/json

{
  "status": 0,
  "response": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "userName": "Mike.Zanyatski",
      "isVisitor": false,
      "firstName": "Mike",
      "lastName": "Zanyatski",
      "email": "my@domain.com",
      "birthday": "2021-12-02T05:36:19.8165390Z",
      "sex": "male",
      "status": 1,
      "activationStatus": 0,
      "terminated": null,
      "department": "Marketing",
      "workFrom": "2021-12-02T05:36:19.8165390Z",
      "location": "Palo Alto",
      "notes": "Notes to worker",
      "displayName": null,
      "title": "Manager",
      "contacts": [
        {
          "type": "GTalk",
          "value": "my@gmail.com"
        }
      ],
      "groups": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "name": "Group Name",
          "manager": "Jake.Zazhitski"
        }
      ],
      "avatarMedium": "url to medium avatar",
      "avatar": "url to big avatar",
      "isAdmin": false,
      "isLDAP": false,
      "listAdminModules": [
        "projects",
        "crm"
      ],
      "isOwner": false,
      "cultureName": "en-EN",
      "isSSO": false,
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    }
  ]
}

text/xml

<result>
  <status>0</status>
  <response>
    <id>00000000-0000-0000-0000-000000000000</id>
    <userName>Mike.Zanyatski</userName>
    <isVisitor>false</isVisitor>
    <firstName>Mike</firstName>
    <lastName>Zanyatski</lastName>
    <email>my@domain.com</email>
    <birthday>2021-12-02T05:36:19.8165390Z</birthday>
    <sex>male</sex>
    <status>1</status>
    <activationStatus>0</activationStatus>
    <terminated />
    <department>Marketing</department>
    <workFrom>2021-12-02T05:36:19.8165390Z</workFrom>
    <location>Palo Alto</location>
    <notes>Notes to worker</notes>
    <displayName />
    <title>Manager</title>
    <contacts>
      <type>GTalk</type>
      <value>my@gmail.com</value>
    </contacts>
    <groups>
      <id>00000000-0000-0000-0000-000000000000</id>
      <name>Group Name</name>
      <manager>Jake.Zazhitski</manager>
    </groups>
    <avatarMedium>url to medium avatar</avatarMedium>
    <avatar>url to big avatar</avatar>
    <isAdmin>false</isAdmin>
    <isLDAP>false</isLDAP>
    <listAdminModules>projects</listAdminModules>
    <listAdminModules>crm</listAdminModules>
    <isOwner>false</isOwner>
    <cultureName>en-EN</cultureName>
    <isSSO>false</isSSO>
    <avatarSmall>url to small avatar</avatarSmall>
    <profileUrl></profileUrl>
  </response>
</result>