Method: getUsers

When requesting getUsers, the values for the "Inactive" and "Employment Ended" statuses are the same — 3. To differentiate between these statuses, use the getUsers/v2 request. In this way, in the status parameter, inactive users will be indicated by status 3, while users who are identified as "Employment Ended" will be indicated by status 5.

If you have more than 1000 users in your account, use the Getting a List of Users (Page-by-Page) request.

Permissions to Run the Request

Account Owner, Account Administrators, Department Administrators, or custom roles.

Department Administrators and users with a custom role can get lists of the users belonging to the departments they manage and their sub-departments.

Parameters

Parameter	Type	Description
credentials (required)	credentials	Read the description of the Credentials object.
groupId (optional)	string	If specified, this method selects users belonging to a specific group.
departmentId (optional)	int	If specified, this method selects users belonging to a specific department.

Return Value

After the request has been completed, the system returns an object with the following properties:

Parameter	Type	Description
users	UserProfile[]	An array of user profiles. The UserProfile object has the same properties as the getUserProfile method.

Possible Errors

Error

Description

Permission denied

The user doesn't have enough permissions to handle the request.

For example, Department Administrator can't get a list of users from a department they don't manage.

Sample Call

<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <GetUsersRequest>
      <credentials>
        <accountUrl>https://myaccount.ispringlearn.com</accountUrl>
        <email>email@email.com</email>
        <password>password</password>
      </credentials>
    </GetUsersRequest>
    <groupId>string</groupId>
    <departmentId>string</departmentId>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

XML

Sample Response

<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <GetUsersResult>
      <userProfile>
	    <userId>43eb7146-6280-11e9-b274-a6210366ac32</userId>
		<role>publisher</role>
		<departmentId>e95b4ad0-5f50-11e9-80c4-0a580af406eb</departmentId>
		<status>1</status>
		<fields>
          <field>
            <name>LOGIN</name>
            <value>helen@ispring.com</value>
          </field>
          <field>
            <name>EMAIL</name>
            <value>helen@ispring.com</value>
          </field>
          <field>
            <name>FIRST_NAME</name>
            <value>Helen</value>
          </field>
          <field>
             <name>LAST_NAME</name>
             <value>Jones</value>
          </field>
          <field>
             <name>JOB_TITLE</name>
             <value>Accountant</value>
          </field>
          <field>
             <name>COUNTRY</name>
             <value>643</value>
          </field>
        </fields>
		<groups>
			<id>e0b394fc-44b9-11e9-92c8-0a580af401f6</id>
		</groups>
		<manageableDepartmentIds>
			<id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id>
		</manageableDepartmentIds>
        <userRoles>
          <userRole>
            <roleId>eaf01e14-2ae1-11e9-89a5-0242ac13000a</roleId>
            <roleType>publisher</roleType>
            <manageableDepartmentIds>
              <id>f9de0c52-6f59-11ea-b88f-cee299842653</id>
              <id>f9d9f306-6f59-11ea-ad9a-cee299842653</id>
            </manageableDepartmentIds>
          </userRole>
        </userRoles>
		<addedDate>2019-04-30</addedDate>
		<lastLoginDate>2019-04-30</lastLoginDate>
	</userProfile>
    <userProfile>
		<userId>43eb7146-6280-11e9-b274-a6210366ac33</userId>
		<role>department_administrator</role>
		<departmentId>e95b4ad0-5f50-11e9-80c4-0a580af406eb</departmentId>
		<status>1</status>
		<fields>
          <field>
            <name>LOGIN</name>
            <value>kevin@ispring.com</value>
          </field>
          <field>
            <name>EMAIL</name>
            <value>kevin@ispring.com</value>
          </field>
          <field>
            <name>FIRST_NAME</name>
            <value>Kevin</value>
          </field>
          <field>
            <name>LAST_NAME</name>
            <value>Klein</value>
          </field>
          <field>
            <name>JOB_TITLE</name>
            <value>Sales Manager</value>
          </field>
          <field>
            <name>COUNTRY</name>
            <value>643</value>
          </field>
        </fields>
		<groups>
		  <id>e0b394fc-44b9-11e9-92c8-0a580af401f6</id>
		</groups>
		<manageableDepartmentIds>
		  <id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id>
		</manageableDepartmentIds>
        <userRoles>
          <userRole>
            <roleId>eaf01e14-2ae1-11e9-89a5-0242ac13111b</roleId>
            <roleType>department_administrator</roleType>
            <manageableDepartmentIds>
              <id>f9de0c52-6f59-11ea-b88f-cee299842653</id>
              <id>f9d9f306-6f59-11ea-ad9a-cee299842653</id>
            </manageableDepartmentIds>
          </userRole>
        </userRoles>
		<addedDate>2019-04-29</addedDate>
		<lastLoginDate>2019-04-30</lastLoginDate>
      </userProfile>
    </GetUsersResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CODE