---
title: "List tasks in a project"
method: POST
path: "/listTasks"
tags: ["Project"]
---

# List tasks in a project

`POST /listTasks`

## Request

- Base URL: `https://www.taskade.com/api/v2`
- URL: `https://www.taskade.com/api/v2/listTasks`
- Auth: OAuth 2 and HTTP bearer
  - Authorization code: `https://www.taskade.com/oauth2/authorize`
  - Token URL: `https://www.taskade.com/oauth2/token`

## Request body

- object
  - `projectId` string, required: The project ID to list tasks for
  - `limit` number
  - `after` string: Cursor: task ID to get tasks after (do not combine with before)
  - `before` string: Cursor: task ID to get tasks before (do not combine with after)
  - `completed` boolean: Set false to list only open tasks, or true to list only completed ones. Leave it out to list both. The filter reads each task's own flag, and the cursors and `limit` apply to the filtered list.

## Response `200`

Default response

- object
  - `ok` true, required
  - `items` object[], required
    - `id` string, required
    - `text` string, required
    - `parentId` string
    - `completed` boolean, required

---

[API](https://skmtc.dev/taskade/apis/taskade-public-api-v2.md) - [All operations](https://skmtc.dev/taskade/apis/taskade-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/taskade/apis/taskade-public-api-v2/revisions/45f0e74ec083?raw)