---
title: "Retrieve a task"
method: GET
path: "/task/{connection_id}/task/{id}"
tags: ["task", "task"]
---

# Retrieve a task

`GET /task/{connection_id}/task/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Response `200`

Successful

- TaskTask
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `project_id` string
  - `parent_id` string
  - `completed_at` string, date-time
  - `status` 'OPENED' | 'IN_PROGRESS' | 'COMPLETED'
  - `notes` string
  - `due_at` string, date-time
  - `start_at` string, date-time
  - `end_at` string, date-time
  - `priority` string
  - `assigned_user_ids` string[]
  - `creator_user_id` string
  - `follower_user_ids` string[]
  - `group_ids` string[]
  - `tags` string[]
  - `url` string
  - `attachment_ids` string[] — Array of attachment IDs retrieved from StorageFile.Get endpoint
  - `metadata` TaskMetadata[]
    - `id` string
    - `value` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `slug` string
  - `has_children` boolean
  - `type` string
  - `time_spent` number
  - `time_spent_unit` string
  - `progress` number
  - `story_points` number
  - `raw` object

## Changes

- **2026-09-09** `3bea28547cc7` — 2 warning
  - removed the optional property `metadata/items/key` from the response with the `200` status
  - removed the optional property `metadata/items/type` from the response with the `200` status
- **2026-07-27** `397324a17233` — 8 info
  - added the enum value `progress` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `story_points` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `time_spent` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `time_spent_unit` to the property `items/` of the `query` request parameter `fields`
  - …4 more
- **2026-07-26** `8f2437668567` — 6 info
  - added the enum value `end_at` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `start_at` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `type` to the property `items/` of the `query` request parameter `fields`
  - added the optional property `end_at` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/unified/apis/unified-to-api/changes/task/:connection_id/task/:id/get.md)

---

[API](https://skmtc.dev/unified/apis/unified-to-api.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api/revisions/e0a7ff925921?raw)