# List users

Returns a paginated list of users within the specified organization.

Endpoint: GET /api/v1/organizations/{organizationId}/users
Version: v1
Security: Bearer, PersonalAccessToken

## Security:

  - `Bearer` (unknown)
    http bearer JWT

  - `PersonalAccessToken` (unknown)
    apiKey in header Personal-Access-Token

## Path parameters:

  - `organizationId` (string, required)
    Unique identifier of the organization

## Query parameters:

  - `SearchText` (string)
    Filter users by a free-text search across given name, surname, and email.

  - `GivenName` (string)
    Filter users by given name.

  - `Surname` (string)
    Filter users by surname.

  - `Email` (string)
    Filter users by email address.

  - `Page` (integer)
    The page number.

  - `PageSize` (integer)
    The number of items per page.

  - `SortingKey` (string)
    The sorting key.

  - `Ascending` (boolean)
    Whether to sort in ascending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `users` (array, required)
    The list of users.

  - `users.id` (string, required)
    The user identifier.
    Example: 00000000-0000-0000-0000-000000000001

  - `users.givenName` (string, required)
    The user's given name.
    Example: Mario

  - `users.surname` (string, required)
    The user's surname.
    Example: Rossi

  - `users.email` (string, required)
    The user's email address.
    Example: mario.rossi@example.com

  - `users.phoneNumber` (string)
    The user's phone number, if set.
    Example: +39 02 1234567

  - `pagination` (object, required)
    Pagination metadata.

  - `pagination.page` (integer, required)
    The current page number.

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

  - `pagination.totalCount` (integer, required)
    The total number of items.

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 422:

  - `422` (unknown)
    Unprocessable Content

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

