# ai_analytics_orgs_users_user_metrics_pie_chart_retrieve

Retrieve user distribution data for pie charts.

This endpoint returns data on the distribution of new versus returning users
within a specified date range, including both counts and percentages,
suitable for pie chart visualization.

Args:
    request: The HTTP request containing filter query parameters.
    org: Organization key identifier.

Returns:
    Response: Distribution of new versus returning users with counts and percentages.

Raises:
    NotFound: If the specified organization does not exist.
    BadRequest: If the provided parameters are invalid.

Query Parameters:
    start_date (str): Start date for filtering (YYYY-MM-DD) - required.
    end_date (str): End date for filtering (YYYY-MM-DD) - required.
    mentor_id (str): Filter by mentor unique ID.

Endpoint: GET /api/ai-analytics/orgs/{org}/users/{user_id}/user-metrics-pie-chart/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `end_date` (string, required)
    End date for filtering (YYYY-MM-DD)

  - `mentor_id` (string)
    Filter by mentor unique ID

  - `start_date` (string, required)
    Start date for filtering (YYYY-MM-DD)

## Path parameters:

  - `org` (string, required)

  - `user_id` (string, required)

## Response 200 fields (application/json):

  - `new_users` (object, required)

  - `new_users.count` (integer, required)

  - `new_users.percentage` (number, required)

  - `returning_users` (object, required)