/
ListUsers (v3)

ListUsers (v3)

Owned by Kiss, Mate
May 24, 2022

Overview

Lists users.

The function is available as a Web Service request.

Request

Parameters of the API request:

ParameterType

Description

Requirements
tokenStringAPI authentication tokenMandatory
filter

UserFilter

Filter parametersMandatory

Response

Parameters of the API response in listUsers type called return:

ParameterType

Description

statusStatus

Possible return values:

    • OK
    • ERROR_GENERAL
    • ERROR_ILLEGAL_ARGUMENT
    • ERROR_UNAUTHORIZED
    • ERROR_NOT_FOUND
    • ERROR_TOO_MANY_RESULT
userCountIntegerNumber of returned Users (returned only if justCount in the filter parameter is true)
users UserUser list (returned only if justCount in the filter parameter is false)

Examples


 Example ListUsers transaction, skipping extension, group and role information.
Example ListUsers transaction, skipping extension, group and role information.
Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v3="http://v3.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <v3:listUsers>
         <token>YWygO3Nw0LlqWWThMKxBa18G3zQ8HKq3</token>
         <filter>
            <environmentFilter>
               <eid>0000</eid>
               <eidExact>0</eidExact>
               <inactive>0</inactive>
               <!--
               <shortName></shortName>
               <shortNameExact></shortNameExact>
               -->
            </environmentFilter>
            <!--  <extension></extension> -->
            <extensionExact>0</extensionExact>
            <!-- <externalId></externalId> -->
            <externalIdExact>0</externalIdExact>
            <!-- <group></group> -->
            <groupExact>0</groupExact>
            <inactive>0</inactive>
            <justCount>0</justCount>
            <!-- <loginName></loginName> -->
            <loginNameExact>0</loginNameExact>
            <!-- <role></role> -->
            <roleExact>0</roleExact>

            <!-- skip extensions, group memberships, roles --> 
            <skipExtensions>1</skipExtensions>
            <skipGroups>1</skipGroups>
            <skipRoles>1</skipRoles>
         </filter>
      </v3:listUsers>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:listUsersResponse xmlns:ns2="http://v3.provisioning.ws.web.verba.com/">
         <return>
            <status>
               <statusCode>OK</statusCode>
            </status>
            <users>
               <apiAccessOnly>false</apiAccessOnly>
               <displayName>Verba Administrator</displayName>
               <eid>0000</eid>
               <email/>
               <environmentShortName>Ref.</environmentShortName>
               <id>1</id>
               <language>en</language>
               <locked>false</locked>
               <loginName>Administrator</loginName>
               <needChangePassword>false</needChangePassword>
               <nonModifiable>false</nonModifiable>
               <passwordExpires>false</passwordExpires>
               <timeZone>Europe/Budapest</timeZone>
               <userType>user_type_verba</userType>
               <validFrom>2014-08-28T07:42:37.193Z</validFrom>
               <validTo>2099-12-31T00:00:00Z</validTo>
            </users>
            <users>
               <apiAccessOnly>false</apiAccessOnly>
               <displayName>Aron Diofasi</displayName>
               <eid>0000</eid>
               <environmentShortName>Ref.</environmentShortName>
               <id>12</id>
               <language>en</language>
               <locked>false</locked>
               <loginName>aron</loginName>
               <needChangePassword>false</needChangePassword>
               <nonModifiable>false</nonModifiable>
               <passwordExpires>false</passwordExpires>
               <timeZone>Europe/Budapest</timeZone>
               <userType>user_type_verba</userType>
               <validFrom>2015-11-19T14:35:26.310Z</validFrom>
               <validTo>2099-12-31T00:00:00Z</validTo>
            </users>
            <users>
               <apiAccessOnly>false</apiAccessOnly>
               <displayName>Bajzat Tamas</displayName>
               <eid>0000</eid>
               <environmentShortName>Ref.</environmentShortName>
               <id>13</id>
               <language>en</language>
               <locked>false</locked>
               <loginName>bajzat</loginName>
               <needChangePassword>false</needChangePassword>
               <nonModifiable>false</nonModifiable>
               <passwordExpires>false</passwordExpires>
               <timeZone>Europe/Budapest</timeZone>
               <userType>user_type_verba</userType>
               <validFrom>2015-11-19T14:35:26.310Z</validFrom>
               <validTo>2099-12-31T00:00:00Z</validTo>
            </users>
         </return>
      </ns2:listUsersResponse>
   </S:Body>
</S:Envelope>
 Example ListUsers transaction. Filtering for a group. Skipping group information.
Example ListUsers transaction. Filtering for a group. Skipping group information.
Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v3="http://v3.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <v3:listUsers>
         <token>YWygO3Nw0LlqWWThMKxBa18G3zQ8HKq3</token>
         <filter>
            <environmentFilter>
               <eid>0000</eid>
               <eidExact>0</eidExact>
               <inactive>0</inactive>
               <!--
               <shortName></shortName>
               <shortNameExact></shortNameExact>
               -->
            </environmentFilter>
            <!--  <extension></extension> -->
            <extensionExact>0</extensionExact>
            <!-- <externalId></externalId> -->
            <externalIdExact>0</externalIdExact>
            <group>Nest group2</group>
            <groupExact>0</groupExact>
            <inactive>0</inactive>
            <justCount>0</justCount>
            <!-- <loginName></loginName> -->
            <loginNameExact>0</loginNameExact>
            <!-- <role></role> -->
            <roleExact>0</roleExact>
            <skipExtensions>0</skipExtensions>
            <skipGroups>1</skipGroups>
            <skipRoles>0</skipRoles>
         </filter>
      </v3:listUsers>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:listUsersResponse xmlns:ns2="http://v3.provisioning.ws.web.verba.com/">
         <return>
            <status>
               <statusCode>OK</statusCode>
            </status>
            <users>
               <agentId/>
               <apiAccessOnly>false</apiAccessOnly>
               <crmUserId/>
               <customDateFormat/>
               <customTimeFormat/>
               <displayName>IPTUser2</displayName>
               <eid>0000</eid>
               <email>AbdulA@VerbaMsftTest.ccsctp.net</email>
               <environmentShortName>Ref.</environmentShortName>
               <extensions>
                  <eid>0000</eid>
                  <environmentShortName>Ref.</environmentShortName>
                  <extension>iptradeTest2</extension>
                  <id>9</id>
                  <im>false</im>
                  <recordingMode>FULL</recordingMode>
                  <screenCaptureEnabled>false</screenCaptureEnabled>
                  <video>false</video>
                  <voice>true</voice>
               </extensions>
               <externalId/>
               <id>7</id>
               <language>en</language>
               <locked>false</locked>
               <loginName>IPTUser2</loginName>
               <needChangePassword>false</needChangePassword>
               <nonModifiable>false</nonModifiable>
               <passwordExpires>false</passwordExpires>
               <roles>r_quality_management_agent</roles>
               <roles>r_standard_user</roles>
               <timeZone>Europe/Budapest</timeZone>
               <userType>user_type_verba</userType>
               <validFrom>2015-09-15T12:17:00Z</validFrom>
               <validTo>2099-12-31T00:00:00Z</validTo>
            </users>
            <users>
               <agentId/>
               <apiAccessOnly>false</apiAccessOnly>
               <crmUserId/>
               <customDateFormat/>
               <customTimeFormat/>
               <displayName>mate</displayName>
               <eid>0000</eid>
               <email/>
               <environmentShortName>Ref.</environmentShortName>
               <extensions>
                  <eid>0000</eid>
                  <environmentShortName>Ref.</environmentShortName>
                  <extension>+12779</extension>
                  <id>15</id>
                  <im>false</im>
                  <recordingMode>FULL</recordingMode>
                  <screenCaptureEnabled>false</screenCaptureEnabled>
                  <video>false</video>
                  <voice>true</voice>
               </extensions>
               <extensions>
                  <eid>0000</eid>
                  <environmentShortName>Ref.</environmentShortName>
                  <extension>12779</extension>
                  <id>16</id>
                  <im>false</im>
                  <recordingMode>FULL</recordingMode>
                  <screenCaptureEnabled>false</screenCaptureEnabled>
                  <video>false</video>
 Example ListUsers transaction. Just count the users in a group.
Example ListUsers transaction. Just count the users in a group.
Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v3="http://v3.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <v3:listUsers>
         <token>YWygO3Nw0LlqWWThMKxBa18G3zQ8HKq3</token>
         <filter>
            <environmentFilter>
               <eid>0000</eid>
               <eidExact>0</eidExact>
               <inactive>0</inactive>
               <!-- <shortName></shortName>
               <shortNameExact></shortNameExact> -->
            </environmentFilter>
            <!--  <extension></extension> -->
            <extensionExact>0</extensionExact>
            <!-- <externalId></externalId> -->
            <externalIdExact>0</externalIdExact>
            <group>Nest group2</group>
            <groupExact>0</groupExact>
            <inactive>0</inactive>
            <justCount>1</justCount> <!-- Just count is TRUE -->
            <!-- <loginName></loginName> -->
            <loginNameExact>0</loginNameExact>
            <!-- <role></role> -->
            <roleExact>0</roleExact>
            <!--
            <skipExtensions>0</skipExtensions>
            <skipGroups>0</skipGroups>
            <skipRoles>0</skipRoles>
            -->
         </filter>
      </v3:listUsers>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:listUsersResponse xmlns:ns2="http://v3.provisioning.ws.web.verba.com/">
         <return>
            <status>
               <statusCode>OK</statusCode>
            </status>
            <userCount>4</userCount>
         </return>
      </ns2:listUsersResponse>
   </S:Body>
</S:Envelope>

Related content

Provisioning API
Provisioning API
VFC Capture (Verba) 9.9
Read with this
ListUsers (v3)
ListUsers (v3)
VFC Capture (Verba) 9.8
More like this
UserFilter (v3)
UserFilter (v3)
VFC Capture (Verba) 9.9
Read with this
ListUsers (v3)
ListUsers (v3)
VFC Capture (Verba) 9.9
More like this
REST API
REST API
VFC Capture (Verba) 9.9
Read with this
ListUsers (v3)
ListUsers (v3)
VFC Capture (Verba) 9.6
More like this