---
title: "Get a pipeline's workflows"
method: GET
path: "/pipeline/{pipeline-id}/workflow"
tags: ["Pipeline"]
---

# Get a pipeline's workflows

`GET /pipeline/{pipeline-id}/workflow`

Returns a paginated list of workflows by pipeline ID.

## Path parameters

- `pipeline-id` string, uuid, required

## Query parameters

- `page-token` string

## Response `200`

A paginated list of workflow objects.

- object — A list of workflows and associated pagination token.
  - `items` object[], required — A list of workflows.
    - `pipeline_id` string, uuid, required — The ID of the pipeline this workflow belongs to.
    - `canceled_by` string, uuid
    - `id` string, uuid, required — The unique ID of the workflow.
    - `auto_rerun_number` integer — Present if this workflow was auto-rerun from a previous workflow. The Nth auto-rerun workflow will have auto_rerun_number N
    - `name` string, required — The name of the workflow.
    - `project_slug` string, required — The project-slug for the pipeline this workflow belongs to.
    - `errored_by` string, uuid
    - `tag` 'setup' — Tag used for the workflow
    - `status` 'success' | 'running' | 'not_run' | 'failed' | 'error' | 'failing' | 'on_hold' | 'canceled' | 'unauthorized', required — The current status of the workflow.
    - `started_by` string, uuid, required
    - `max_auto_reruns` integer — The maximum number of auto reruns specified for the workflow.
    - `pipeline_number` integer, required — The number of the pipeline this workflow belongs to.
    - `created_at` string, date-time, required — The date and time the workflow was created.
    - `stopped_at` string, date-time, required — The date and time the workflow stopped.
  - `next_page_token` string, required — A token to pass as a `page-token` query parameter to return the next page of results.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/circleci/apis/api-v2.md) · [All operations](https://skmtc.net/circleci/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/circleci/api-v2/versions/b9c0e0c24058/schema)