Sign in
latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

User

Get Productivity Stats

Get comprehensive productivity statistics for the authenticated user. This endpoint is used to display information about the Karma system.

Returns detailed completion statistics including:

  • Daily completion counts with per-project breakdowns for the last 7 days
  • Weekly completion counts with per-project breakdowns for the last 4 weeks
  • Total completed task count
  • Karma score, trend, graph data, and update history
  • Goal settings (daily/weekly goals, ignore days, vacation mode)
  • Streak information (current, last, and maximum daily and weekly streaks)
  • Project color mappings for visualization
get/api/v1/tasks/completed/stats

Response

Successful Response

project_colorsobject required

Mapping of project IDs to their color names (e.g., {'2aB3cD4eF5gH6iJ7': 'blue', '8kL9mN0oP1qR2sT3': 'red'})

completed_countinteger required

Total number of tasks completed by the user (all time)

karmanumber required

Current karma score

karma_trendstring required

Karma trend indicator ('up' or 'down')

karma_last_updatenumber required

Net karma change from the most recent update (positive_karma + negative_karma)

Example response

{
  "days_items": [
    {
      "date": "2025-02-12",
      "items": [],
      "total_completed": 3
    }
  ],
  "week_items": [
    {
      "from": "2025-02-10",
      "items": [],
      "to": "2025-02-16",
      "total_completed": 12
    }
  ],
  "project_colors": {
    "6XGgm6PHrGgMpCFX": "blue"
  },
  "completed_count": 42,
  "karma": 1024,
  "karma_trend": "up",
  "karma_graph_data": [
    {
      "date": "2025-02-12",
      "karma_avg": 1024
    }
  ],
  "karma_last_update": 1,
  "karma_update_reasons": [
    {
      "negative_karma": 0,
      "negative_karma_reasons": [
        50
      ],
      "new_karma": 1024,
      "positive_karma": 1,
      "positive_karma_reasons": [
        2,
        9
      ],
      "time": "2025-02-12T10:30:00Z"
    }
  ],
  "goals": {
    "user": "1234567",
    "user_id": "1234567",
    "daily_goal": 5,
    "weekly_goal": 25,
    "ignore_days": [
      6,
      0
    ],
    "current_daily_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    },
    "current_weekly_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    },
    "last_daily_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    },
    "last_weekly_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    },
    "max_daily_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    },
    "max_weekly_streak": {
      "count": 5,
      "start": "2025-02-10",
      "end": "2025-02-14"
    }
  }
}