---
name: "glab-ci-list"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-ci-list"
---

# glab-ci-list(1)

List CI/CD pipelines.

## NAME

glab-ci-list - List CI/CD pipelines.

## SYNOPSIS

**glab ci list \[flags\]**

## DESCRIPTION

Defaults to the current project. Use **--status** to filter pipelines by status.

## OPTIONS

**--jq**=""\
 	Filter JSON output with a jq expression.

**-n**, **--name**=""\
 	Return only pipelines with the given name.

**-o**, **--order**="id"\
 	Order pipelines by this field. Options: id, status, ref, updated\_at, user\_id.

**-F**, **--output**="text"\
 	Format output. Options: text, json.

**-p**, **--page**=1\
 	Page number.

**-P**, **--per-page**=0\
 	Number of items to list per page. Defaults to the GitLab API default (20).

**-r**, **--ref**=""\
 	Return only pipelines for the given ref.

**--scope**=""\
 	Return only pipelines with the given scope. Options: running, pending, finished, branches, tags.

**--sha**=""\
 	Return only pipelines with the given SHA.

**--sort**="desc"\
 	Sort direction for '--order': asc or desc.

**--source**=""\
 	Return only pipelines triggered by the given source. For the full list, see https://docs.gitlab.com/ci/jobs/job\_rules/#ci\_pipeline\_source-predefined-variable. Commonly used options: merge\_request\_event, parent\_pipeline, pipeline, push, trigger.

**-s**, **--status**=""\
 	Filter pipelines by status. Options: running, pending, success, failed, canceled, skipped, created, manual, waiting\_for\_resource, preparing, scheduled.

**-a**, **--updated-after**=""\
 	Return only pipelines updated after the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z).

**-b**, **--updated-before**=""\
 	Return only pipelines updated before the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z).

**-u**, **--username**=""\
 	Return only pipelines triggered by the given username.

**-y**, **--yaml-errors**\[=false\]\
 	Return only pipelines with invalid configurations.

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

**-R**, **--repo**=""\
 	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

## EXAMPLE

```
glab ci list
glab ci list --status=failed
```

## SEE ALSO

**[glab-ci(1)](/glab-ci/1.md)**