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

# GET /run/{id}/task

`GET /run/{id}/task`

Returns a list of tasks and status information within their specified run. Use this operation to monitor runs and to identify which specific tasks have failed.

## Path parameters

- `id` string, required

## Query parameters

- `status` 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'COMPLETED' | 'CANCELLED' | 'FAILED'
- `startingToken` string
- `maxResults` integer

## Response `200`

Success

- ListRunTasksResponse
  - `items` TaskListItem[] — A list of tasks.
    - `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 count.
    - `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 gigabyes.
    - `creationTime` string, date-time — When the task was created.
    - `startTime` string, date-time — When the task started.
    - `stopTime` string, date-time — When the task stopped.
    - `gpus` integer — The number of Graphics Processing Units (GPU) specified for the task.
    - `instanceType` string — The instance type for a task.
  - `nextToken` string — A pagination token that's included if more results are available.

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