# Get a list of available users

Endpoint: GET /users
Version: 1.5
Security: bearerAuth

## Query parameters:

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

  - `username` (string)
    Filter by username
    Example: "xyz | in:x,y | like:xyz"

  - `email` (string)
    Filter by email
    Example: "xyz | in:x,y | like:xyz"

  - `firstName` (string)
    Filter by first name
    Example: "xyz | in:x,y | like:xyz"

  - `lastName` (string)
    Filter by last name
    Example: "xyz | in:x,y | like:xyz"

  - `contractOwner` (string)
    Filter by contract owner name
    Example: "xyz | in:x,y | like:xyz"

  - `enabled` (string)
    A boolean flag to specify if the user is enabled or disabled
    Example: "true | false"

## Response 200 fields (application/json):

  - `id` (integer)
    User identifier
    Example: 1

  - `username` (string, required)
    Username

  - `firstName` (string, required)
    First name

  - `lastName` (string, required)
    Last name

  - `email` (string, required)
    Email address
    Example: "annon@annon.com"

  - `telephoneNumber` (string)
    Telephone number

  - `mobileNumber` (string)
    Mobile telephone number

  - `contractOwnerId` (integer)
    Contract Owner identifier (Optional Contract Owner to associate the user to. If they are associated to a Contract Owner then they will only be able to see and manage that Contract Owner's data)
    Example: 1

  - `enabled` (boolean)
    User is enabled

  - `userRoles` (array, required)
    Example: [1]


## Response 400 fields

## Response 401 fields

## Response 403 fields