# ai_analytics_orgs_users_user_metrics_retrieve

Retrieve comprehensive user metrics.

This endpoint returns data on various user metrics with month-over-month
change calculations:
- Registered users: Total users registered on the platform
- New users: Users who joined in the current month
- Unique users: Distinct users who have had sessions
- Veteran users: Users who have been active for at least 6 months

Results can be filtered by mentor.

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

Returns:
    Response: Comprehensive user metrics with month-over-month changes.

Raises:
    NotFound: If the specified organization does not exist.

Query Parameters:
    mentor_id (str): Filter metrics by mentor unique ID.

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

## Query parameters:

  - `group_by` (string)

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

## Path parameters:

  - `org` (string, required)

  - `user_id` (string, required)

## Response 200 fields (application/json):

  - `registered_users` (object, required)

  - `registered_users.total` (integer, required)

  - `registered_users.change_percentage` (number, required)

  - `new_users` (object, required)

  - `unique_users` (object, required)

  - `veteran_users` (object, required)