---
title: "List user tasks"
method: GET
path: "/public/v1/tasks"
tags: ["User Tasks"]
---

# List user tasks

`GET /public/v1/tasks`

Lists user tasks — the account 'To-dos' inbox. Filter by `assigned_to_me`, `completed`, `object_name` (tasks linked to an object), or `people_ids`/`team_ids`. Each task includes assignees and the linked object record (if any). Requires a USER API key. Distinct from object-row tasks (`/objects/{object}/rows/{rowId}/tasks`) and from Max tasks.

## Query parameters

- `assigned_to_me` 'true' | 'false' — Only tasks assigned to the calling user.
- `completed` 'true' | 'false' — Filter by completion state.
- `object_name` string — Only tasks linked to this object.
- `people_ids` string — CSV of People record IDs linked to the task.
- `team_ids` string — CSV of team IDs the task is shared with.

## Response `200`

A list of tasks

- object — Standard list response
  - `results` PublicUserTask[], required
    - `id` number, required
    - `content` string, required
    - `due_date` string, nullable
    - `completed` boolean, required
    - `completed_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
    - `created_by` object, nullable
      - `id` number, required
      - `name` string, nullable
      - `email` string, nullable
    - `completed_by` object, nullable
      - `id` number, required
      - `name` string, nullable
      - `email` string, nullable
    - `assignees` object[], required — Assigned users
      - `id` number, required
      - `name` string, nullable
      - `email` string, nullable
    - `related` object, nullable — Linked object record, if the task is attached to one (else null).
      - `object_name` string, nullable — Object the task is linked to (the slug used in /objects commands).
      - `object_label` string, nullable
      - `row_id` string, nullable

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/versions/9d33b6aad674/schema)