---
title: "GET /run"
method: GET
path: "/run"
---

# GET /run

`GET /run`

Retrieves a list of runs and returns each run's metadata and status.

Amazon Web Services HealthOmics stores a configurable number of runs, as determined by service limits, that are available to the console and API. If the `ListRuns` response doesn't include specific runs that you expected, you can find all run logs in the CloudWatch logs. For more information about viewing the run logs, see [CloudWatch logs](https://docs.aws.amazon.com/omics/latest/dev/monitoring-cloudwatch-logs.html) in the _Amazon Web Services HealthOmics User Guide_.

## Query parameters

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

## Response `200`

Success

- ListRunsResponse
  - `items` RunListItem[] — A list of runs.
    - `arn` string — The run's ARN.
    - `id` string — The run's ID.
    - `status` 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'COMPLETED' | 'DELETED' | 'CANCELLED' | 'FAILED' — The run's status.
    - `workflowId` string — The run's workflow ID.
    - `batchId` string — The run's batch ID.
    - `name` string — The run's name.
    - `priority` integer — The run's priority.
    - `storageCapacity` integer — The run's storage capacity in gibibytes. For dynamic storage, after the run has completed, this value is the maximum amount of storage used during the run.
    - `creationTime` string, date-time — When the run was created.
    - `startTime` string, date-time — When the run started.
    - `stopTime` string, date-time — When the run stopped.
    - `storageType` 'STATIC' | 'DYNAMIC' — The run's storage type.
    - `workflowVersionName` string — The name of the workflow version.
    - `workflowName` string — The name of the workflow.
  - `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)