# ai_analytics_orgs_users_user_sentiment_retrieve

Retrieve user sentiment distribution.

This endpoint returns data on the distribution of user sentiments (positive,
negative, neutral) within a specified date range, expressed as percentages.

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

Returns:
    Response: Sentiment distribution percentages and total sentiment count.

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.

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

## Query parameters:

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

  - `group_by` (string)

  - `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):

  - `sentiment_distribution` (object, required)

  - `total_sentiments` (integer, required)