List tasks

GET /v1/tasks

Returns every task in the team that the API key’s owner has access to. A user has access to a task if they:

• created the task, or
• are assigned to the task, or
• are a member of a non-archived list the task is attached to.

Soft-deleted tasks and tasks reachable only through archived lists are never returned. Filters compose with AND; the array filters (taskListId, assigneeId, taskStatusId, priority) match any of the supplied values — repeat the parameter to pass several.

Request

Query parameters

Name	Type	Required	Description
taskListId	string	no	Filter on task list ID. Repeat the parameter to match any of several lists.
query	string	no	Free-text title filter (case-insensitive substring match).
assigneeId	string	no	Filter on assignee user ID. Repeat the parameter to match any of several assignees.
taskStatusId	string	no	Filter on status ID. Repeat the parameter to match any of several statuses.
isCompleted	string	no	"true" for only completed tasks, "false" for only non-completed; omit to return both.
priority	string	no	One of low, medium, high, urgent. Repeat the parameter to match several priorities.
dueDateFrom	string	no	Inclusive lower bound for dueDate (ISO date YYYY-MM-DD).
dueDateTo	string	no	Inclusive upper bound for dueDate (ISO date YYYY-MM-DD).
limit	string	no	Hard cap on the number of returned tasks. Integer between 1 and 1000. Defaults to 1000.

No request body.

Response

200 OK — array of task summaries.

Field	Type	Description
id	number	Numeric ID of the task.
title	string	Task title.
number	number	Auto-incrementing task number within the team.
priority	string | null	One of low, medium, high, urgent, or null.
dueDate	string | null	ISO 8601 date the task is due, or null.
parentId	number | null	Parent task ID if this is a subtask, otherwise null.
createdAt	string	ISO 8601 timestamp the task was created.
updatedAt	string	ISO 8601 timestamp of the last update.
isCompleted	boolean	true if the task’s status is in a completed state.
status	object	Current status of the task — see below.
status.id	number	Numeric ID of the status.
status.name	string	Display name of the status.
assignees	array of objects	Users currently assigned. May be empty.
assignees[].id	string	User ID (UUID).
assignees[].name	string	User’s display name.
assignees[].email	string	User’s email address.
taskLists	array of objects	Lists this task is attached to. May be empty.
taskLists[].id	number	Numeric ID of the list.
taskLists[].name	string	Display name of the list.

Example response

[
  {
    "id": 421,
    "title": "Wire up onboarding email",
    "number": 87,
    "priority": "high",
    "dueDate": "2026-05-12",
    "parentId": null,
    "createdAt": "2026-05-01T09:14:22.000Z",
    "updatedAt": "2026-05-08T11:02:08.000Z",
    "isCompleted": false,
    "status": { "id": 3, "name": "In progress" },
    "assignees": [
      { "id": "u_abc123", "name": "Tom", "email": "tom@example.com" }
    ],
    "taskLists": [
      { "id": 12, "name": "Marketing site" }
    ]
  }
]