# Search users

Returns a list of users based on the filter criteria

Endpoint: GET /v1/users
Version: 1.0

## Query parameters:

  - `filter.search` (string)
    Search text (applies to: name & email address)

  - `filter.permission` (string)
    <p>Options:</p><ul><li>CreateMatters</li><li>ContractCreator</li></ul>

  - `filter.activeandinvitedusersonly` (boolean)
    Only users that are active or invited

  - `filter.primaryorganisationid` (integer)

  - `filter.activeusersonly` (boolean)
    Only users that are active

  - `filter.uselitequery` (boolean)
    Use a lite query
When enabled the response will return only partial information about the user:
UserId, FirstName, LastName, UserFullName and OrganisationName

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (text/plain):

  - `id` (string)

  - `userName` (string)

  - `firstName` (string)

  - `lastName` (string)

  - `organisationName` (string)

  - `organisationPictureCacheId` (integer)

  - `directPhone` (string)

  - `mobilePhone` (string)

  - `email` (string)

  - `hasPicture` (boolean)

  - `pictureCacheId` (integer)

  - `invitationSentUtc` (string)

  - `userFullName` (string)

  - `userInitials` (string)

  - `isRemoved` (boolean)

  - `isDisabled` (boolean)

  - `hourlyRate` (number)

  - `liveMattersCount` (integer)