---
title: "Get Filtered Team Tasks"
method: GET
path: "/v2/team/{team_Id}/task"
tags: ["Tasks"]
---

# Get Filtered Team Tasks

`GET /v2/team/{team_Id}/task`

View the tasks that meet specific criteria from a Workspace. Responses are limited to 100 tasks per page.  \
 \
You can only view task information of tasks you can access. \
 \
Each task's `custom_fields` array only includes Custom Fields applicable to that task's `custom_item_id`.\
 \
 Our Try It modal currently supports filtering by two or more Lists, Folders, or Spaces. To filter by a single List, Folder, or Space, we recommend using a free app like [Postman](https://www.postman.com/) to test our public API.

## Path parameters

- `team_Id` number, required

## Query parameters

- `page` integer
- `order_by` string
- `reverse` boolean
- `subtasks` boolean
- `space_ids[]` string[]
- `project_ids[]` string[]
- `list_ids[]` string[]
- `statuses[]` string[]
- `include_closed` boolean
- `assignees[]` string[]
- `tags[]` string[]
- `due_date_gt` integer
- `due_date_lt` integer
- `date_created_gt` integer
- `date_created_lt` integer
- `date_updated_gt` integer
- `date_updated_lt` integer
- `date_done_gt` integer
- `date_done_lt` integer
- `custom_fields` string[]
- `parent` string
- `include_markdown_description` boolean
- `custom_items[]` number[]

## Response `200`

- object
  - `tasks` object[], required
    - `id` string, required
    - `custom_id` string, nullable, required
    - `name` string, required
    - `text_content` string, required
    - `description` string, required
    - `markdown_description` string
    - `status` Status, required — unresolved $ref
    - `orderindex` string, required
    - `date_created` string, required
    - `date_updated` string, required
    - `date_closed` string, required
    - `date_done` string, nullable, required
    - `creator` object, required
      - `id` integer, required
      - `username` string, required
      - `color` string, required
      - `email` string, required
      - `profilePicture` string, required
    - `assignees` object[], required
      - `id` integer, required
      - `username` string, required
      - `color` string, required
      - `email` string, required
      - `profilePicture` string, required
    - `watchers` object[], required
      - `id` integer, required
      - `username` string, required
      - `color` string, required
      - `email` string, required
      - `profilePicture` string, required
    - `checklists` object[], required
      - `id` string, required
      - `task_id` string, required
      - `name` string, required
      - `date_created` string, required
      - `orderindex` integer, required
      - `creator` integer, required
      - `resolved` integer, required
      - `unresolved` integer, required
      - `items` Items[], required — unresolved $ref
    - `tags` Items[], required — unresolved $ref
    - `parent` string, required
    - `priority` integer, required
    - `due_date` string, required
    - `start_date` string, required
    - `points` number, required
    - `time_estimate` number, required
    - `custom_fields` object[], required
      - `id` string, required
      - `name` string, required
      - `type` string, required
      - `type_config` object, required
      - `date_created` string, required
      - `hide_from_guests` boolean, required
      - `required` boolean, required
    - `dependencies` string[], required
    - `linked_tasks` string[], required
    - `locations` Items[] — Array of Lists where the task has been added. — unresolved $ref
    - `team_id` string, required
    - `url` string, required
    - `permission_level` string, required
    - `list` object, required
      - `id` string, required
      - `name` string, required
      - `access` boolean, required
    - `project` object, required
      - `id` string, required
      - `name` string, required
      - `hidden` boolean, required
      - `access` boolean, required
    - `folder` Folder, required — unresolved $ref
    - `space` Space, required — unresolved $ref

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)