---
title: "List the activities of a task"
method: GET
path: "/v1/task-activities"
tags: ["TaskActivity"]
---

# List the activities of a task

`GET /v1/task-activities`

Returns the activities of one task in chronological order, each with its screenshots. One activity is one stretch of time spent in one application.

## Query parameters

- `taskId` string, required
- `page` integer
- `limit` integer

## Response `200`

Activities of the task

- TaskActivityList
  - `items` TaskActivityDto[]
    - `id` string
    - `user` string
    - `taskId` string
    - `appName` string
    - `appExecutable` string
    - `titles` TaskActivityTitleDto[]
      - `title` string
      - `seconds` integer
    - `startDateTime` string
    - `endDateTime` string
    - `source` string
    - `images` TaskActivityImageDto[]
      - `id` string
      - `taskActivityId` string
      - `taskId` string
      - `dateTime` string
      - `fileSize` integer
      - `width` integer
      - `height` integer
      - `lastUpdate` integer
      - `created` integer
    - `lastUpdate` integer
    - `created` integer
  - `params` ListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `400` — Bad request - taskId missing or task not found
- `401` — Not authorized
- `403` — Invalid permission - the task belongs to someone else

## Changes

> 8 revisions in range; 1 not diffed.

- **2026-09-21** `4f2bf90abf25` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/timesheet/apis/timesheet-api/changes/v1/task-activities/get.md)

---

[API](https://skmtc.dev/timesheet/apis/timesheet-api.md) · [All operations](https://skmtc.dev/timesheet/apis/timesheet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timesheet/apis/timesheet-api/revisions/a3d2f44e7345?raw)