Stats

The stats endpoint returns a comprehensive dashboard summary of your GTD system, including task counts, completion rates, habit streaks, and productivity insights.

GET /api/v1/stats

Get dashboard statistics for the authenticated user.

Response

{
  "tasks": {
    "total": 142,
    "completed": 98,
    "completion_rate": 0.69,
    "today": {
      "total": 8,
      "completed": 3
    },
    "overdue": 2,
    "by_urgency": {
      "Urgent": 12,
      "Not Urgent": 25,
      "Habit": 5
    },
    "by_importance": {
      "Important": 18,
      "Not Important": 15,
      "Moved the Needle": 9
    },
    "by_state": {
      "Flow": 10,
      "Quick": 15,
      "Easy": 8,
      "Personal": 9
    }
  },
  "habits": {
    "total": 6,
    "active_streaks": [
      {
        "habit_id": "clx9a0b1c...",
        "name": "Morning meditation",
        "current_streak": 14,
        "longest_streak": 30
      }
    ],
    "today_completed": 4,
    "today_total": 6
  },
  "projects": {
    "total": 8,
    "by_status": {
      "Ongoing": 4,
      "Deadline": 2,
      "Fav": 1,
      "Completed": 1,
      "Moved the Needle": 0,
      "Archived": 0
    }
  },
  "bottlenecks": {
    "total": 3,
    "priority_count": 1
  },
  "reviews": {
    "last_weekly": "2026-03-15",
    "last_monthly": "2026-03-01"
  }
}

Response Fields