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

# Get Task

`GET /v2/task/{task_id}`

View information about a task. You can only view task information of tasks you can access. \
 \
Tasks with attachments will return an "attachments" response. \
 \
Docs attached to a task are not returned.\
 \
The `custom_fields` array only includes Custom Fields applicable to the task's `custom_item_id`. Use [Get Custom Fields](https://developer.clickup.com/reference/getaccessiblecustomfields) and each field's `applied_objects` to discover which fields apply to which task types.

## Path parameters

- `task_id` string, required

## Query parameters

- `custom_task_ids` boolean
- `team_id` number
- `include_subtasks` boolean
- `include_markdown_description` boolean
- `custom_fields` string[]

## Response `200`

- 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 — Only returned if `include_markdown_description=true` is passed as a query parameter.
  - `status` object
    - `id` string
    - `status` string
    - `color` string
    - `orderindex` integer
    - `type` string
  - `orderindex` string
  - `date_created` string
  - `date_updated` string
  - `date_closed` string, nullable
  - `date_done` string, nullable
  - `archived` boolean
  - `creator` object
    - `id` integer
    - `username` string
    - `color` string
    - `email` string
    - `profilePicture` string, nullable
  - `assignees` object[]
    - `id` integer
    - `username` string
    - `color` string
    - `initials` string
    - `email` string
    - `profilePicture` string, nullable
  - `group_assignees` object[]
  - `watchers` object[]
    - `id` integer
    - `username` string
    - `color` string
    - `initials` string
    - `email` string
    - `profilePicture` string, nullable
  - `checklists` object[]
  - `tags` object[]
    - `name` string
    - `tag_fg` string
    - `tag_bg` string
    - `creator` integer
  - `parent` string, nullable
  - `top_level_parent` string, nullable
  - `priority` object, nullable
    - `color` string
    - `id` string
    - `orderindex` string
    - `priority` string
  - `due_date` string, nullable
  - `start_date` string, nullable
  - `points` number, nullable
  - `time_estimate` number, nullable
  - `time_spent` number, nullable
  - `custom_fields` object[] — Custom Fields applicable to the task's `custom_item_id`. Fields scoped to other custom task types are excluded. Fields without a value may still appear with their definition.
    - `id` string
    - `name` string
    - `type` string
    - `type_config` object — The configuration of the Custom Field. The structure of this object varies depending on the [Custom Field type](ref:docs/customfields).
    - `date_created` string
    - `hide_from_guests` boolean
    - `value` unknown
    - `value_richtext` string
    - `value_markdown` string
    - `required` boolean
  - `dependencies` object[]
    - `task_id` string
    - `depends_on` string
    - `type` integer
    - `date_created` string
    - `userid` string
    - `workspace_id` string
    - `chain_id` string, nullable
  - `linked_tasks` object[]
  - `locations` object[] — Array of Lists where the task has been added.
    - `id` string — The ID of the List where the task has been added.
    - `name` string — The name of the List where the task has been added.
  - `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` object
    - `id` string
    - `name` string
    - `access` boolean
  - `project` Folder — unresolved $ref
  - `folder` object
    - `id` string
    - `name` string
    - `hidden` boolean
    - `access` boolean
  - `space` object
    - `id` string
  - `subtasks` object[] — Only returned if `include_subtasks=true` is passed as a query parameter.
    - `id` string
    - `custom_item_id` number, nullable
    - `name` string
    - `status` object
      - `status` string
      - `orderindex` integer
      - `color` string
      - `type` string
    - `orderindex` string
    - `date_created` string
    - `date_updated` string
    - `date_closed` string, nullable
    - `date_done` string, nullable
    - `archived` boolean
    - `creator` Creator — unresolved $ref
    - `assignees` object[]
      - `id` integer
      - `username` string
      - `color` string
      - `initials` string
      - `email` string
      - `profilePicture` string, nullable
    - `group_assignees` object[]
    - `watchers` object[]
    - `checklists` object[]
    - `tags` object[]
    - `parent` string, nullable
    - `top_level_parent` string, nullable
    - `due_date` string, nullable
    - `start_date` string, nullable
    - `points` number, nullable
    - `time_estimate` number, nullable
    - `time_spent` number, nullable
    - `custom_fields` Items[] — unresolved $ref
    - `dependencies` object[]
    - `linked_tasks` object[]
    - `locations` object[]
    - `url` string
  - `attachments` object[]
    - `id` string
    - `date` integer
    - `title` string
    - `type` integer
    - `source` integer
    - `version` integer
    - `extension` string
    - `thumbnail_small` string
    - `thumbnail_medium` string
    - `thumbnail_large` string
    - `is_folder` boolean
    - `mimetype` string
    - `hidden` boolean
    - `parent_id` string
    - `size` integer
    - `total_comments` integer
    - `resolved_comments` integer
    - `user` object
      - `id` integer
      - `username` string
      - `initials` string
      - `email` string
      - `color` string
      - `profilePicture` string
    - `deleted` boolean
    - `orientation` string
    - `url` string
    - `email_data` object
    - `url_w_query` string
    - `url_w_host` string

---

[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)