---
title: "List all pipeline runs within the Org ordered newest to oldest. This can be filtered by app, pipeline, and status."
method: GET
path: "/orgs/{orgId}/pipeline-runs"
tags: ["public", "PipelineRuns"]
---

# List all pipeline runs within the Org ordered newest to oldest. This can be filtered by app, pipeline, and status.

`GET /orgs/{orgId}/pipeline-runs`

## Path parameters

- `orgId` string, required

## Query parameters

- `app` string[]
- `pipeline` string[]
- `env` string
- `status` string[]
- `completed` boolean
- `created_after` string, date-time
- `created_before` string, date-time
- `per_page` integer
- `page` string

## Response `200`

Successful list response. If the Link header is present, more data may be available.

- PipelineRun[]
  - `id` string, required — The unique id of the Run.
  - `etag` string, required — The current entity tag value for this Run.
  - `org_id` string, required — The id of the Organization containing this Run.
  - `app_id` string, required — The id of the Application containing this Run.
  - `env_ids` string[], required — Environments linked to this Pipeline Run through input parameters or step executions.
  - `pipeline_id` string, required — The id of the Pipeline associated with the Run.
  - `pipeline_version` string, required — The id of the Pipeline Version associated with the Run.
  - `status` string, required — The current status of this Run.
  - `status_message` string, required — A human-readable message indicating the reason for the status.
  - `created_at` string, date-time, required — The date and time when this Run was first created.
  - `created_by` string, required — User id that created or triggered the Run.
  - `executing_at` string, date-time — The date and time when this Run entered executing status.
  - `cancellation_requested_at` string, date-time — The date and time when cancellation of this Run was requested.
  - `completed_at` string, date-time — The date and time when this Run entered a successful, failed, or cancelled status.
  - `timeout_seconds` integer, required — The timeout for this Run.
  - `trigger` string, required — The trigger type that was triggered this Run to start.
  - `inputs` object, required — The inputs that were provided for this Run.
  - `run_as` string, required — The user id that the pipeline run is executing as when it calls Humanitec APIs.
  - `concurrency_group` string — The optional concurrency group for this run within the application
  - `waiting_for` object, required — Aggregated events on which run's jobs are waiting for

## Other responses

- `400` — The request was invalid. More detail can be found in the error body.
- `404` — Either the resource or a related resource could not be found. More detail can be found in the error body.

---

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