---
title: "Get Tasks"
method: GET
path: "/v2/list/{list_id}/task"
tags: ["Tasks"]
---

# Get Tasks

`GET /v2/list/{list_id}/task`

View the tasks in a List. Responses are limited to 100 tasks per page. You can only view task information of tasks you can access. \
 \
This endpoint only includes tasks where the specified `list_id` is their home List. Tasks added to the `list_id` with a different home List are not included in the response by default. To include tasks that exist in multiple lists, use the `include_timl` parameter. \
 \
The `time_spent` field displays time tracked in milliseconds, and is only included in the response for tasks with time entries.\
 \
Each task's `custom_fields` array only includes Custom Fields applicable to that task's `custom_item_id`.

## Path parameters

- `list_id` number, required

## Query parameters

- `archived` boolean
- `include_markdown_description` boolean
- `page` integer
- `order_by` string
- `reverse` boolean
- `subtasks` boolean
- `statuses` string[]
- `include_closed` boolean
- `include_timl` boolean
- `assignees` string[]
- `watchers` 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[]
- `custom_field` string[]
- `custom_items` number[]

## Response `200`

- object
  - `tasks` object[]
    - `id` string
    - `custom_id` string, nullable
    - `custom_item_id` number, nullable — The custom task type ID for this task. A value of `0` represents task type "Task".\ \ To get a list of available custom task type IDs for your Workspace, use the [Get Custom Task Types endpoint](https://developer.clickup.com/reference/getcustomitems).
    - `name` string
    - `text_content` string
    - `description` string
    - `markdown_description` string
    - `status` Status — unresolved $ref
    - `orderindex` union
      - string
      - number
    - `date_created` string
    - `date_updated` string
    - `date_closed` string, nullable
    - `date_done` string, nullable
    - `archived` boolean
    - `creator` Creator — unresolved $ref
    - `assignees` string[]
    - `group_assignees` string[]
    - `watchers` string[]
    - `checklists` string[]
    - `tags` string[]
    - `parent` string, nullable
    - `top_level_parent` string, nullable
    - `priority` Priority — unresolved $ref
    - `due_date` string, nullable
    - `start_date` string, nullable
    - `points` number, nullable
    - `time_estimate` string, nullable
    - `time_spent` number — Time tracked in milliseconds. Only included in the response for tasks with time entries.
    - `custom_fields` object[]
      - `id` string
      - `name` string
      - `type` string — The Custom Field type.
      - `type_config` object — [Configuration options](https://developer.clickup.com/docs/customfields#the-type_config-property) specific to each Custom Field based on the Custom Field type.
      - `date_created` string
      - `hide_from_guests` boolean
      - `required` boolean
    - `dependencies` string[]
    - `linked_tasks` string[]
    - `locations` Items[] — Array of Lists where the task has been added. — unresolved $ref
    - `team_id` string
    - `url` string
    - `sharing` object
      - `public` boolean
      - `public_share_expires_on` string, nullable
      - `public_fields` string[]
      - `token` string, nullable
      - `seo_optimized` boolean
    - `permission_level` string
    - `list` List — unresolved $ref
    - `project` Folder — unresolved $ref
    - `folder` Folder — unresolved $ref
    - `space` Space — unresolved $ref
  - `last_page` boolean

---

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