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

# GET /workflow

`GET /workflow`

Retrieves a list of existing workflows. You can filter for specific workflows by their name and type. Using the type parameter, specify <code>PRIVATE</code> to retrieve a list of private workflows or specify <code>READY2RUN</code> for a list of all Ready2Run workflows. If you do not specify the type of workflow, this operation returns a list of existing workflows.

## Query parameters

- `type` 'PRIVATE' | 'READY2RUN'
- `name` string
- `startingToken` string
- `maxResults` integer

## Response `200`

Success

- ListWorkflowsResponse
  - `items` WorkflowListItem[] — A list of workflow items.
    - `arn` string — The workflow's ARN.
    - `id` string — The workflow's ID.
    - `name` string — The workflow's name.
    - `status` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETED' | 'FAILED' | 'INACTIVE' — The workflow's status.
    - `type` 'PRIVATE' | 'READY2RUN' — The workflow's type.
    - `digest` string — The workflow's digest.
    - `creationTime` string, date-time — When the workflow was created.
    - `metadata` object — Any metadata available for workflow. The information listed may vary depending on the workflow, and there may also be no metadata to return.
  - `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)