# ai_analytics_orgs_users_user_cohorts_over_time_retrieve

Retrieve user cohort trends over time.

This endpoint returns data on the distribution of new versus veteran users
over time, with options for different time aggregations and filtering by mentor.
New users are those who registered within the specified date range, while
veteran users are those who registered before the date range but were active
during it.

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

Returns:
    Response: Time series of new and veteran user counts.

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.
    aggregation (str): Time aggregation level (hourly, daily, weekly) - default: daily.
    mentor_id (str): Filter by mentor unique ID.

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

## Query parameters:

  - `aggregation` (string)
    Time aggregation level (hourly, daily, weekly)
    Enum: "daily", "hourly", "weekly"

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

  - `periods` (array, required)

  - `new_users` (array, required)

  - `veteran_users` (array, required)