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

# GET /runBatch

`GET /runBatch`

Returns a list of run batches in your account, with optional filtering by status, name, or run group. Results are paginated. Only one filter per call is supported.

## Query parameters

- `maxItems` integer
- `startingToken` string
- `status` 'CREATING' | 'PENDING' | 'SUBMITTING' | 'INPROGRESS' | 'STOPPING' | 'CANCELLED' | 'FAILED' | 'PROCESSED' | 'RUNS_DELETING' | 'RUNS_DELETED'
- `name` string
- `runGroupId` string

## Response `200`

Success

- ListBatchResponse
  - `items` BatchListItem[] — A list of batch summary objects. See <code>BatchListItem</code>.
    - `id` string — The batch identifier.
    - `name` string — The batch name.
    - `status` 'CREATING' | 'PENDING' | 'SUBMITTING' | 'INPROGRESS' | 'STOPPING' | 'CANCELLED' | 'FAILED' | 'PROCESSED' | 'RUNS_DELETING' | 'RUNS_DELETED' — The current batch status.
    - `createdAt` string, date-time — The timestamp when the batch was created.
    - `totalRuns` integer — The total number of runs in the batch.
    - `workflowId` string — The identifier of the workflow used for the batch.
  - `nextToken` string — A pagination token to retrieve the next page of results. Absent when no further results are available.

## Other responses

- `480` — InternalServerException
- `481` — ThrottlingException
- `482` — ValidationException
- `483` — AccessDeniedException
- `484` — 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)