# List users

Retrieves all users via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, display_name, status, manager_uuid, license_type, display_name, status, manager_uuid, license_type.

Available ransackable associations and their attributes:
- teams: teams_uuid, teams_display_name, teams_parent_uuid, teams_status, teams_name, teams_is_org, teams_parent_uuid
- team_memberships: team_memberships_uuid, team_memberships_user_uuid
- profile: profile_uuid, profile_first_name, profile_last_name, profile_job_title, profile_employee_type, profile_department_name, profile_division_name, profile_cost_center_name, profile_custom_field_1, profile_custom_field_2, profile_custom_field_3, profile_custom_field_4, profile_custom_field_5
- manager: manager_uuid, manager_display_name, manager_status, manager_manager_uuid, manager_license_type, manager_display_name, manager_status, manager_manager_uuid, manager_license_type

Endpoint: GET /rest/v2/users
Version: v2

## Query parameters:

  - `page` (number)
    Page number for pagination (default: 1)

  - `per_page` (number)
    Number of records per page (default: 20, max: 100)

  - `limit` (number)
    Alias for per_page - number of records per page

  - `limit_max` (number)
    Maximum number of records per page (overrides limit if not set)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 422 fields

## Response 429 fields

## Response 500 fields