# Search users

Lists users in the organization with optional search, role, and group filtering, supporting pagination.

Request:
searchQuery   - Free-text query to filter users by email or name.
roleId        - Optional role ID to return only users with that role.
groupId       - Optional group ID to return only users in that group.
pagination     - Optional Pagination cursor and page size for iterating large result sets.

Response:
users          - List of User objects matching the filter criteria.
pageCursor    - Opaque cursor for the next page. Absent when there are no further results.

Endpoint: POST /api/v1/user/list-users
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `searchQuery` (string)
    Rule data fields

  - `roleId` (string)
    Rule data fields

  - `groupId` (string)
    Rule data fields

  - `pagination` (any)

  - `includeApiUsers` (boolean)

## Response 200 fields (application/json):

  - `users` (array)

  - `users.id` (string)
    Rule data fields

  - `users.email` (string)
    Rule data fields

  - `users.firstName` (string)
    Rule data fields

  - `users.lastName` (string)
    Rule data fields

  - `users.department` (string)
    Rule data fields

  - `users.roleId` (string)
    Rule data fields

  - `users.isAdmin` (boolean)

  - `users.groupIds` (array)

  - `users.lastLogin` (object)

  - `users.lastLogin.seconds` (integer)

  - `users.lastLogin.nanos` (integer)

  - `users.profilePictureUrl` (string)
    Rule data fields

  - `users.isEnabled` (boolean)

  - `users.username` (string)
    Rule data fields

  - `users.isInvited` (boolean)

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)