---
title: "Get task"
method: GET
path: "/rest/api/3/task/{taskId}"
tags: ["Tasks"]
---

# Get task

`GET /rest/api/3/task/{taskId}`

Returns the status of a [long-running asynchronous task](#async).

When a task has finished, this operation returns the JSON blob applicable to the task. See the documentation of the operation that created the task for details. Task details are not permanently retained. As of September 2019, details are retained for 14 days although this period may change without notice.

**Deprecation notice:** The required OAuth 2.0 scopes will be updated on June 15, 2024.

 *  `read:jira-work`

**[Permissions](#permissions) required:** either of:

 *  *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).
 *  Creator of the task.

## Path parameters

- `taskId` string, required

## Response `200`

Returned if the request is successful.

- TaskProgressBeanObject — Details about a task.
  - `description` string — The description of the task.
  - `elapsedRuntime` integer, required — The execution time of the task, in milliseconds.
  - `finished` integer — A timestamp recording when the task was finished.
  - `id` string, required — The ID of the task.
  - `lastUpdate` integer, required — A timestamp recording when the task progress was last updated.
  - `message` string — Information about the progress of the task.
  - `progress` integer, required — The progress of the task, as a percentage complete.
  - `result` unknown
  - `self` string, uri, required — The URL of the task.
  - `started` integer — A timestamp recording when the task was started.
  - `status` 'ENQUEUED' | 'RUNNING' | 'COMPLETE' | 'FAILED' | 'CANCEL_REQUESTED' | 'CANCELLED' | 'DEAD', required — The status of the task.
  - `submitted` integer, required — A timestamp recording when the task was submitted.
  - `submittedBy` integer, required — The ID of the user who submitted the task.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.
- `404` — Returned if the task is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)