---
title: "GET /runBatch/{batchId}/run"
method: GET
path: "/runBatch/{batchId}/run"
---

# GET /runBatch/{batchId}/run

`GET /runBatch/{batchId}/run`

Returns a paginated list of individual workflow runs within a specific batch. Use this operation to map each <code>runSettingId</code> to its HealthOmics-generated <code>runId</code>, and to check the submission status of each run. Only one filter per call is supported.

## Path parameters

- `batchId` string, required

## Query parameters

- `maxItems` integer
- `startingToken` string
- `submissionStatus` 'SUCCESS' | 'FAILED' | 'CANCEL_SUCCESS' | 'CANCEL_FAILED' | 'DELETE_SUCCESS' | 'DELETE_FAILED'
- `runSettingId` string
- `runId` string

## Response `200`

Success

- ListRunsInBatchResponse
  - `runs` RunBatchListItem[] — A list of run entries in the batch. See <code>RunBatchListItem</code>.
    - `runSettingId` string — The customer-provided identifier for the run configuration. Use this to correlate results back to the input configuration provided in <code>inlineSettings</code> or <code>s3UriSettings</code>.
    - `runId` string — The HealthOmics-generated identifier for the workflow run. Empty if submission failed.
    - `runInternalUuid` string — The universally unique identifier (UUID) for the run.
    - `runArn` string — The unique ARN of the workflow run.
    - `submissionStatus` 'SUCCESS' | 'FAILED' | 'CANCEL_SUCCESS' | 'CANCEL_FAILED' | 'DELETE_SUCCESS' | 'DELETE_FAILED' — The submission outcome for this run.
    - `submissionFailureReason` string — The error category for a failed submission. See the run-level failure table in the HealthOmics User Guide for details on each value.
    - `submissionFailureMessage` string — A detailed message describing the submission failure.
  - `nextToken` string — A pagination token to retrieve the next page of results. Absent when the last run has been returned.

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