# Returns a paginated list of users, optionally filtered by a search query

Endpoint: GET /v1/users
Version: V1
Security: authorization_code_with_pkce, client_credentials

## Query parameters:

  - `searchText` (string)
    Search query

  - `page` (integer)
    Requested page

  - `pageSize` (integer)
    Requested pagesize

## Response 200 fields (application/json):

  - `items` (array, required)
    The items on the current page.

  - `items.id` (string, required)
    The unique identifier of the user.
    Example: "00000000-0000-0000-0000-000000000001"

  - `items.userName` (string, required)
    The username (login name) of the user.
    Example: "jane.doe@aritma.com"

  - `items.email` (string, required)
    The email address of the user.
    Example: "jane.doe@aritma.com"

  - `items.phoneNumber` (string, required)
    The phone number of the user, if registered.
    Example: "+4712345678"

  - `items.twoFactorEnabled` (boolean, required)
    Indicates whether two-factor authentication is enabled for the user.

  - `items.roles` (array, required)
    The roles assigned to the user.

  - `items.roles.id` (string, required)
    The unique identifier of the role.

  - `items.roles.name` (string, required)
    The name of the role.

  - `metadata` (object, required)
    Pagination details such as current page, page size, and total count.

  - `metadata.page` (integer, required)
    The current page number (1-based).

  - `metadata.pageSize` (integer, required)
    The number of items per page.

  - `metadata.totalCount` (integer, required)
    The total number of items across all pages.

  - `links` (object, required)
    Navigation links for first, previous, next, and last pages.

  - `links.first` (string,null)
    Link to the first page.

  - `links.previous` (string,null)
    Link to the previous page, if one exists.

  - `links.next` (string,null)
    Link to the next page, if one exists.

  - `links.last` (string,null)
    Link to the last page.


## Response 401 fields

## Response 403 fields