---
title: "List runs within a pipeline ordered newest to oldest."
method: GET
path: "/orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs"
tags: ["public", "PipelineRuns"]
---

# List runs within a pipeline ordered newest to oldest.

`GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs`

## Path parameters

- `orgId` string, required
- `appId` string, required
- `pipelineId` string, required

## Query parameters

- `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)