> ## Documentation Index
> Fetch the complete documentation index at: https://developer.findity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search users

> Returns the users this caller is allowed to impersonate, filtered by `searchText`. Used by admins to pick a target user before starting an impersonation session. The list is empty when the caller is already impersonating another user — you can't chain impersonations from within an active session.



## OpenAPI

````yaml openapi/findity-expense-api.json GET /impersonation/users/search
openapi: 3.0.3
info:
  title: Findity Expense API
  description: Findity Expense API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/expense
  - url: https://api.findity.com/api/v1/expense
security:
  - bearerAuth: []
paths:
  /impersonation/users/search:
    get:
      tags:
        - Impersonation
      summary: Search users
      description: >-
        Returns the users this caller is allowed to impersonate, filtered by
        `searchText`. Used by admins to pick a target user before starting an
        impersonation session. The list is empty when the caller is already
        impersonating another user — you can't chain impersonations from within
        an active session.
      operationId: impersonationUsersSearch
      parameters:
        - $ref: '#/components/parameters/searchText'
        - $ref: '#/components/parameters/max'
        - $ref: '#/components/parameters/offset'
        - name: sort
          in: query
          description: Comma separated list of properties to sort on with defined order
          required: false
          example: firstName:desc,lastName:asc
          schema:
            type: string
            default: number:asc
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArrayOfPersonSearchResult'
              example:
                meta:
                  total: 2
                  count: 2
                data:
                  - personId: a61fa8a24d9d49f7b75d1874257e044a
                    firstName: Emma
                    lastName: Expense
                    email: emma.expense@example.com
                    clientApplication: Findity
                    clientApplicationId: 1234
                    impersonatorType: PERSON
                    profilePictureUrl: >-
                      https://expense.findity.com/api/v1/expense/profileimage/a61fa8a24d9d49f7b75d1874257e044a
                  - personId: a1fee2b7c13b450988870ac59231beb5
                    firstName: Max
                    lastName: Expense
                    email: max.expense@example.com
                    clientApplication: Findity
                    clientApplicationId: 1234
                    impersonatorType: EMPLOYEE
                    profilePictureUrl: >-
                      https://expense.findity.com/api/v1/expense/profileimage/a1fee2b7c13b450988870ac59231beb5
components:
  parameters:
    searchText:
      name: searchText
      in: query
      description: free text to search for
      required: false
      schema:
        type: string
    max:
      name: max
      in: query
      description: max records to return
      required: false
      schema:
        type: integer
        format: int
        minimum: 1
        maximum: 1000
        default: 10
    offset:
      name: offset
      in: query
      description: the offset to be used in list
      required: false
      schema:
        type: integer
        format: int
        minimum: 0
        default: 0
  schemas:
    ArrayOfPersonSearchResult:
      type: object
      properties:
        meta:
          properties:
            count:
              type: integer
            total:
              type: integer
        data:
          type: array
          items:
            $ref: '#/components/schemas/PersonSearchResult'
    PersonSearchResult:
      type: object
      properties:
        personId:
          $ref: '#/components/schemas/Uuid'
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
        profilePictureUrl:
          type: string
        clientApplication:
          type: string
        clientApplicationId:
          type: string
        impersonatorType:
          $ref: '#/components/schemas/ImpersonatorType'
    Uuid:
      type: string
      pattern: ^[0-9a-fA-F]{32}$
      description: UUID without dashes (32-character hex string)
    ImpersonatorType:
      type: string
      enum:
        - PERSON
        - EMPLOYEE
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````