# search_users_orgs_users_retrieve

Search and filter users within a specific organization/tenant.

This endpoint provides a search interface for discovering users within an organization,
with support for filtering by departments, pagination, and faceted filtering.

Path Parameters:
    org (str): The organization/tenant identifier
    username (str): The username of the user making the request

Query Parameters:
    # Search parameters
    query (str, optional): Search term to filter users by name, username, or email

    # Department filtering
    department_mode (bool, optional): Enable department-based filtering (default: false)
    user_department (bool, optional): Legacy parameter for department_mode (default: false)
    department (list, optional): Filter by specific departments

    # Additional filters
    role (list, optional): Filter by user role
    status (list, optional): Filter by user status (active, inactive)
    joined_date (list, optional): Filter by join date range
    last_login (list, optional): Filter by last login date range

    # Pagination
    limit (int, optional): Number of results per page (default: 10)
    offset (int, optional): Starting position for pagination

Returns:
    A JSON response containing:
    
Error Responses:
    400 Bad Request: If the request parameters are invalid
    403 Forbidden: If the user doesn't have department admin privileges (when using department_mode)
    404 Not Found: If the user or organization doesn't exist
    500 Internal Server Error: If an unexpected error occurs

Access Control:
    - The requesting user must have an active account in the specified organization
    - When department_mode is enabled, the user must be an admin of at least one department
    - Department filtering restricts results to users in departments where the requesting user is an admin

Endpoint: GET /api/search/users/orgs/{org}/users/{username}/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `department` (array)
    Filter by department names

  - `education__degree` (string)
    Filter by degree

  - `education__field_of_study` (string)
    Filter by field of study

  - `education__institution` (string)
    Filter by institution

  - `include_membership_data` (boolean)
    Include user group membership data in results

  - `limit` (integer)
    Number of results per page

  - `offset` (integer)
    Starting position for pagination

  - `q` (string)
    Search term to filter users by name, email, or other attributes

  - `user_resume__company` (string)
    Filter by company

  - `user_resume__industry` (string)
    Filter by industry

  - `user_resume__job_title` (string)
    Filter by job title

  - `user_resume__location` (string)
    Filter by location

  - `user_resume__skills` (string)
    Filter by skills

## Path parameters:

  - `org` (string, required)

  - `username` (string, required)

## Response 200 fields (application/json):

  - `results` (array, required)
    List of search results (can include user_resume, education, institution, etc.)

  - `count` (integer, required)
    Total number of results

  - `next` (string,null, required)
    URL for the next page of results

  - `previous` (string,null, required)
    URL for the previous page of results

  - `current_page` (integer, required)
    Current page number

  - `total_pages` (integer, required)
    Total number of pages