---
title: "List of the approval requests"
method: GET
path: "/orgs/{orgId}/apps/{appId}/approvals"
tags: ["public", "PipelineApprovals"]
---

# List of the approval requests

`GET /orgs/{orgId}/apps/{appId}/approvals`

List of the approval requests with in an app.

## Path parameters

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

## Query parameters

- `per_page` integer
- `page` string
- `pipeline` string[]
- `run` string[]
- `status` string

## Response `200`

Successful list response.

- PipelineApprovalRequest[]
  - `id` string, required — The id of the approval object.
  - `org_id` string, required — The id of the Organization.
  - `app_id` string, required — The id of the Application.
  - `pipeline_id` string, required — The id of the Pipeline.
  - `run_id` string, required — The id of the Pipeline's Run.
  - `job_id` string, required — The id of the Run's Job.
  - `env_id` string, required — The environment for which the approver needs to have deploy permission to approve the job.
  - `message` string, required — A human-readable message indicating the reason for approval.
  - `created_at` string, date-time, required — The date and time when the approval request was created.
  - `status` 'waiting' | 'approved' | 'denied' | 'cancelled', required — The current status of the approval request.
  - `approved_by` string — The user who approved or denied the request.
  - `approved_at` string, date-time — The date and time when the request was approved or denied.

## Other responses

- `400` — The request was invalid. 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)