Skip to main content
GET
/
analytics
curl -X GET "https://api.hitler.app/analytics?timeRange=30d" \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "taskMetrics": {
    "totalCreated": 245,
    "totalCompleted": 198,
    "completionRate": 81,
    "avgCompletionTime": 24,
    "overdueCount": 12
  },
  "moodMetrics": {
    "averageScore": 3.7,
    "totalResponses": 156,
    "trend": "up",
    "distribution": [
      { "score": 5, "count": 32 },
      { "score": 4, "count": 58 },
      { "score": 3, "count": 45 },
      { "score": 2, "count": 15 },
      { "score": 1, "count": 6 }
    ]
  },
  "teamMetrics": {
    "activeUsers": 18,
    "totalUsers": 24,
    "topPerformers": [
      { "id": "usr_123", "name": "Alice Smith", "completedTasks": 34 },
      { "id": "usr_456", "name": "Bob Johnson", "completedTasks": 28 },
      { "id": "usr_789", "name": "Carol Davis", "completedTasks": 25 }
    ]
  },
  "flagMetrics": {
    "total": 15,
    "bySeverity": [
      { "severity": "critical", "count": 2 },
      { "severity": "high", "count": 4 },
      { "severity": "medium", "count": 6 },
      { "severity": "low", "count": 3 }
    ],
    "resolved": 11,
    "pending": 4
  }
}

Get Analytics

Returns comprehensive analytics data including task metrics, mood metrics, team performance, and flag statistics.
This endpoint is only accessible to users with manager or admin roles.

Request

Authorization
string
required
Bearer token from authentication
timeRange
string
default:"30d"
Time range for analytics data. Options: 7d, 30d, 90d

Response

Task Metrics

taskMetrics.totalCreated
number
Total tasks created in the time period
taskMetrics.totalCompleted
number
Total tasks completed in the time period
taskMetrics.completionRate
number
Percentage of tasks completed (0-100)
taskMetrics.avgCompletionTime
number
Average time to complete a task in hours
taskMetrics.overdueCount
number
Number of tasks that became overdue in the period

Mood Metrics

moodMetrics.averageScore
number
Average mood score (1-5)
moodMetrics.totalResponses
number
Total mood check-ins recorded
moodMetrics.trend
string
Mood trend: up, down, or stable
moodMetrics.distribution
array
Array of { score: number, count: number } showing distribution

Team Metrics

teamMetrics.activeUsers
number
Users who had activity in the time period
teamMetrics.totalUsers
number
Total users in the organization
teamMetrics.topPerformers
array
Top 3 users by completed tasks: { id, name, completedTasks }

Flag Metrics

flagMetrics.total
number
Total flags raised in the period
flagMetrics.bySeverity
array
Breakdown by severity: { severity, count }
flagMetrics.resolved
number
Number of resolved flags
flagMetrics.pending
number
Number of pending flags
curl -X GET "https://api.hitler.app/analytics?timeRange=30d" \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "taskMetrics": {
    "totalCreated": 245,
    "totalCompleted": 198,
    "completionRate": 81,
    "avgCompletionTime": 24,
    "overdueCount": 12
  },
  "moodMetrics": {
    "averageScore": 3.7,
    "totalResponses": 156,
    "trend": "up",
    "distribution": [
      { "score": 5, "count": 32 },
      { "score": 4, "count": 58 },
      { "score": 3, "count": 45 },
      { "score": 2, "count": 15 },
      { "score": 1, "count": 6 }
    ]
  },
  "teamMetrics": {
    "activeUsers": 18,
    "totalUsers": 24,
    "topPerformers": [
      { "id": "usr_123", "name": "Alice Smith", "completedTasks": 34 },
      { "id": "usr_456", "name": "Bob Johnson", "completedTasks": 28 },
      { "id": "usr_789", "name": "Carol Davis", "completedTasks": 25 }
    ]
  },
  "flagMetrics": {
    "total": 15,
    "bySeverity": [
      { "severity": "critical", "count": 2 },
      { "severity": "high", "count": 4 },
      { "severity": "medium", "count": 6 },
      { "severity": "low", "count": 3 }
    ],
    "resolved": 11,
    "pending": 4
  }
}