V3 Get a List of Internal Users

Returns a list of Encompass internal users in the organization. You can use query parameters to filter the list of users.

This API added with the 24.2 release of Encompass.

Usage Notes

  • Access Rights
    • Only administrators (admin account, Super Administrator persona, and/or Administrator persona) or non-admin users with the Settings “Organizations/User” persona can retrieve user accounts.
    • The calling user only has access to retrieve users within their same organization, or lower child organizations of their organization.
  • To retrieve a list of organization ids, refer to V1 Get All Organizations.
  • Use the ‘orgId’ parameter to specify the organization (folder) where the users are located. To retrieve users from the specified organization, as well as child organizations, use ‘isRecursive=true’. To retrieve all users across all organizations, use parameters ‘orgId=0’ to retrieve all users in the root organization, with ‘isRecursive=true’ to retrieve all child organizations under the root org.
  • Filter parameters can be used to filter the list of users down even further, based on other user-level attributes. See filters parameter below for more information on the available filters.
  • The entities parameter can be used to limit the data returned to just the specified entities. Default = ‘summary’. To retrieve all entities, use ‘entities=all’.
  • The licenses entity is a fixed list of all 50 states and territories. When ‘entities=all’ or ‘entities=licenses’ is provided, you will receive the entire list of states and territories, including those that the user is not licensed in.
Query Params
integer

Optional. Organization entity unique identifier of the organization folder under which the user exists. If not provided, the default is the root organization (i.e., the 'Administration' organization (orgId=0)).

boolean

Optional. Allow inclusion of child organization (i.e., an organization's sub-folders). When isRecursive=true, any users that exist within the child organization of the parent ‘orgId’ will also be returned. If not provided, default is false.

string

Optional. To retrieve specific entities of the InternalUsers object. Supported values are:
Summary,AccountInformation,Licenses,Personas,UserGroups,PeerLoanAccess,LoCompPlans,CcSite,Comments,EmailSignature,All
If no value is provided, default entity is Summary.

integer

Optional. Starting index or record number from which to retrieve the organization details. The default is Zero.

integer

Optional. The maximum number of records to return in a page. Response size is limited to 6 MB and is recalculated if the response exceeds 6 MB. You will receive an error if it exceeds 6 MB. The default value is 10. The max record is 100.

string

Optional. Additional text filters to filter by contract properties. Filter value must be wrapped in single quotes (e.g. ‘true’). Multiple filters can be used, separated by comma, treated as ‘AND’ statements.
Supported filter fields are: UserId,FirstName,LastName,MiddleName,Suffix,FullName,EmailId,AccountEnabled
Supported operators are:
= performs EXACT search
: performs LIKE search
| performs IN search (example: filter=filter field|(’value1’, 'value2', 'value3')

Headers
string
required

Bearer token

Responses

204

No Content

400

Bad Request

404

Not Found

Language
URL
Response
Choose an example:
application/json