---
title: "GET /run/{id}/task/{taskId}"
method: GET
path: "/run/{id}/task/{taskId}"
---

# GET /run/{id}/task/{taskId}

`GET /run/{id}/task/{taskId}`

Gets detailed information about a run task using its ID.

## Path parameters

- `id` string, required
- `taskId` string, required

## Response `200`

Success

- GetRunTaskResponse
  - `taskId` string — The task's ID.
  - `status` 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'COMPLETED' | 'CANCELLED' | 'FAILED' — The task's status.
  - `name` string — The task's name.
  - `cpus` integer — The task's CPU usage.
  - `cacheHit` boolean — Set to true if Amazon Web Services HealthOmics found a matching entry in the run cache for this task.
  - `cacheS3Uri` string — The S3 URI of the cache location.
  - `memory` integer — The task's memory use in gigabytes.
  - `creationTime` string, date-time — When the task was created.
  - `startTime` string, date-time — The task's start time.
  - `stopTime` string, date-time — The task's stop time.
  - `statusMessage` string — The task's status message.
  - `logStream` string — The task's log stream.
  - `gpus` integer — The number of Graphics Processing Units (GPU) specified in the task.
  - `instanceType` string — The instance type for a task.
  - `failureReason` string — The reason a task has failed.
  - `imageDetails` object — Details about the container image that this task uses.
    - `image` string — The URI of the container image.
    - `imageDigest` string — The container image digest. If the image URI was transformed, this will be the digest of the container image referenced by the transformed URI.
    - `sourceImage` string — URI of the source registry. If the URI is from a third-party registry, Amazon Web Services HealthOmics transforms the URI to the corresponding ECR path, using the pull-through cache mapping rules.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException
- `485` — ResourceNotFoundException
- `486` — AccessDeniedException
- `487` — RequestTimeoutException

---

[API](https://skmtc.net/aws/apis/omics.md) · [All operations](https://skmtc.net/aws/apis/omics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/omics/versions/e9df1bcc0813/schema)