# analytics_time_retrieve

Time Analytics API - User activity patterns by time of day and day of week.
        
        Provides heatmap data showing when users are most active, useful for:
        - Understanding peak usage times
        - Capacity planning and resource allocation
        - User behavior analysis
        - Support scheduling optimization
        
        Key Features:
        - Day of week patterns (0=Sunday through 6=Saturday)
        - Hour of day activity levels (0-23)
        - Flexible date range filtering
        - Platform and mentor-specific filtering
        - Message count aggregation
        
        Data Structure:
        - day_of_week: 0-6 (Sunday-Saturday)
        - hour: 0-23 (24-hour format)
        - value: Message count for that time slot

Endpoint: GET /api/analytics/time/
Version: 4.84.1-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `date_filter` (string)
    * today - Today only
* 7d - Last 7 days
* 30d - Last 30 days
* 90d - Last 90 days
* all_time - All time
* custom - Custom date range
    Enum: "today", "7d", "30d", "90d", "all_time", "custom"

  - `end_date` (string)

  - `granularity` (string)
    * day - day
* hour - hour
* week - week
* month - month
    Enum: "day", "hour", "week", "month"

  - `mentor_unique_id` (string)

  - `platform_key` (string)

  - `start_date` (string)

## Response 200 fields (application/json):

  - `day_of_week` (integer, required)

  - `hour` (integer, required)

  - `value` (integer, required)


## Response 400 fields

## Response 403 fields

## Response 500 fields