List tasks

Retrieve all tasks belonging to the authenticated user.

This endpoint returns only the tasks that belong to the authenticated user. Tasks created by other users are never included in the response.

Response

200 OK — Returns an array of task objects, each paired with an all-time completion count. Tasks are ordered by created_at ascending.

[] · object[] · required

Array of task-with-count objects.

Show properties

task · object · required

The task object.

Show properties

id · number · required

Unique identifier for the task.

user_id · string · required

UUID of the user who owns the task.

challenge_template_id · number | null · required

ID of the associated challenge template, or null.

title · string · required

Display name of the task.

description · string | null · required

Optional description, or null.

points · number · required

Points awarded per completion.

is_daily_routine · boolean · required

Whether the task is flagged as a daily routine.

created_at · string · required

ISO 8601 creation timestamp.

updated_at · string · required

ISO 8601 last-updated timestamp.

completion_count · number · required

Total number of times this task has been completed across all time.

Errors

Status	Condition
401	Missing or invalid authentication token.

cURL

curl --request GET \
  --url http://localhost:3000/api/tasks/me \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "task": {
      "id": 42,
      "user_id": "a3f1c2d4-0e5b-4a7f-b891-2c3d4e5f6a7b",
      "challenge_template_id": null,
      "title": "Meditate for 10 minutes",
      "description": "Morning meditation session",
      "points": 20,
      "is_daily_routine": true,
      "created_at": "2026-03-17T08:00:00.000Z",
      "updated_at": "2026-03-17T08:00:00.000Z"
    },
    "completion_count": 7
  },
  {
    "task": {
      "id": 43,
      "user_id": "a3f1c2d4-0e5b-4a7f-b891-2c3d4e5f6a7b",
      "challenge_template_id": null,
      "title": "Read 20 pages",
      "description": null,
      "points": 10,
      "is_daily_routine": false,
      "created_at": "2026-03-17T09:30:00.000Z",
      "updated_at": "2026-03-17T09:30:00.000Z"
    },
    "completion_count": 3
  }
]

{
  "error": "User not authenticated"
}