--- title: '`glab ci list`' stage: AI Clients group: Developer Clients info: To determine the technical writer assigned to the Stage/Group associated with this page, see --- List CI/CD pipelines. ## Synopsis Defaults to the current project. Use `--status` to filter pipelines by status. ```plaintext glab ci list [flags] ``` ## Examples ```console glab ci list glab ci list --status=failed ``` ## Options ```plaintext --jq string Filter JSON output with a jq expression. -n, --name string Return only pipelines with the given name. -o, --order string Order pipelines by this field. Options: id, status, ref, updated_at, user_id. (default "id") -F, --output string Format output. Options: text, json. (default "text") -p, --page int Page number. (default 1) -P, --per-page int Number of items to list per page. Defaults to the GitLab API default (20). -r, --ref string Return only pipelines for the given ref. --scope string Return only pipelines with the given scope. Options: running, pending, finished, branches, tags. --sha string Return only pipelines with the given SHA. --sort string Sort direction for '--order': asc or desc. (default "desc") --source string 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 string Filter pipelines by status. Options: running, pending, success, failed, canceled, skipped, created, manual, waiting_for_resource, preparing, scheduled. -a, --updated-after string Return only pipelines updated after the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z). -b, --updated-before string Return only pipelines updated before the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z). -u, --username string Return only pipelines triggered by the given username. -y, --yaml-errors Return only pipelines with invalid configurations. ``` ## Options inherited from parent commands ```plaintext -h, --help Show help for this command. -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted. ```