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

# GET /runGroup

`GET /runGroup`

Retrieves a list of all run groups and returns the metadata for each run group.

## Query parameters

- `name` string
- `startingToken` string
- `maxResults` integer

## Response `200`

Success

- ListRunGroupsResponse
  - `items` RunGroupListItem[] — A list of groups.
    - `arn` string — The group's ARN.
    - `id` string — The group's ID.
    - `name` string — The group's name.
    - `maxCpus` integer — The group's maximum CPU count setting.
    - `maxRuns` integer — The group's maximum concurrent run setting.
    - `maxDuration` integer — The group's maximum duration setting in minutes.
    - `creationTime` string, date-time — When the group was created.
    - `maxGpus` integer — The maximum GPUs that can be used by a run group.
  - `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)