---
title: "Get task details"
method: GET
path: "/msp/v2/tasks/{taskID}"
tags: ["Tasks"]
---

# Get task details

`GET /msp/v2/tasks/{taskID}`

Returns the status and additional information about a particular task using the Task ID.

## Path parameters

- `taskID` string, required

## Headers

- `Authorization` string, required

## Response `200`

Ok

- GetTaskResponse
  - `id` string — The unique ID of the task. Example - 'c8b54819-486a-497a-b86e-5b93f2422711'
  - `name` string — The name of the task for which this activity was initiated. Example - 'customerCreate'
  - `entityType` string — - The entity type of the task. Example - 'MSP' - This field contains information to be consumed by MSP services, caller should not interpret, use or depend on its presence in response.
  - `entityId` string — - The unique entity ID of the task. Example - MSP:25a2d3d0-3e17-40f4-945e-66fff6c6e853 - This field contains information to be consumed by MSP services, caller should not interpret, use or depend on its presence in response.
  - `status` integer — - The status of the task. - 1 - Queued - 2 - InProgress - 3 - Paused - 4 - Finished
  - `output` object — output will only contain successResp or errorResp
    - `failed` integer — The status of the output. Example - 0 - 0 - Success - 1 - Failed - -1 - Internal use
    - `successResp` object
      - `entityId` string — The unique ID of the entity created using this task. Example - '1e9b6464-69ac-47d8-b97b-7f595d47504c'
    - `errorResp` object
      - `code` integer — If an error has occurred and the task has failed, an error code is displayed. Example - 2304
      - `message` string — Error message. Example - 'Customer name already exists'
  - `createdOn` string, date-time — The date and time on which the MSP task was created. Example - '2022-10-15T00:00:00Z'
  - `updatedOn` string, date-time — The date and time on which the MSP task was last updated. Example - '2022-10-15T00:00:00Z'

## Other responses

- `400` — Bad Request
- `500` — The request was not processed due to an internal error in MSP Portal Service.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)