---
title: "List all project pipelines"
method: GET
path: "/api/v4/projects/{id}/pipelines"
tags: ["pipelines"]
---

# List all project pipelines

`GET /api/v4/projects/{id}/pipelines`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/pipelines`
- Auth: none declared

Lists all pipelines in a project. By default, child pipelines are not included in the results. To return child pipelines, set `source` to `parent_pipeline`.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `scope` 'running' | 'pending' | 'finished' | 'branches' | 'tags'
- `status` 'created' | 'waiting_for_resource' | 'preparing' | 'waiting_for_callback' | 'pending' | 'running' | 'success' | 'failed' | 'canceling' | 'canceled' | 'skipped' | 'manual' | 'scheduled'
- `ref` string
- `sha` string
- `yaml_errors` boolean
- `username` string
- `updated_before` string, date-time
- `updated_after` string, date-time
- `created_before` string, date-time
- `created_after` string, date-time
- `order_by` 'id' | 'status' | 'ref' | 'updated_at' | 'user_id'
- `sort` 'asc' | 'desc'
- `source` 'unknown' | 'push' | 'web' | 'trigger' | 'schedule' | 'api' | 'external' | 'pipeline' | 'chat' | 'webide' | 'merge_request_event' | 'external_pull_request_event' | 'parent_pipeline' | 'ondemand_dast_scan' | 'ondemand_dast_validation' | 'security_orchestration_policy' | 'container_registry_push' | 'duo_workflow' | 'pipeline_execution_policy_schedule' | 'dependency_management_security_update'
- `name` string

## Response `200`

List all project pipelines

- APIEntitiesCiPipelineBasic[]
  - `id` integer, required
  - `iid` integer, required
  - `project_id` integer, required
  - `sha` string, required
  - `ref` string, required
  - `status` string, required
  - `source` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `web_url` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)