# Returns a paginated list of available roles that can be assigned to users, optionally filtered by a query

Endpoint: GET /v1/role
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 role.

  - `items.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