---
title: "List All Workflow Approvals"
method: GET
path: "/workflows/{id}/approvals"
tags: ["Workflows"]
---

# List All Workflow Approvals

`GET /workflows/{id}/approvals`

Returns a list of approvals for the workflow. The `approvalGroups` property will display only triggered approvals (i.e. conditional approvals that have not been triggered will not appear). 

**OAuth Scope required:** `public.workflows.readApprovals`

## Path parameters

- `id` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- object
  - `workflowId` string
  - `title` string
  - `approvalGroups` object[]
    - `reviewers` object[]
      - `role` string
      - `displayName` string
      - `reviewerType` string
      - `status` 'pending' | 'approved' — The status of the reviewer. If the status is `approved`, the reviewer has approved. If the status is `pending`, the reviewer has not yet approved.
    - `status` 'pending' | 'approved' | 'active' — The status of the approval group. If the status is `active`, the approval group is currently reviewing and its reviewers may approve. If the status is `approved`, all reviewers in the approval group have approved. If the status is `pending`, the approval group is waiting for prior groups to approve and its reviewers cannot approve.
    - `order` integer — The order in which the approval group is executed. Only relevant if there is more than one approval group and sequential approvals are enabled.
  - `roles` object[]
    - `id` string
    - `displayName` string
    - `assignees` object[]
      - `userName` string
      - `userId` string
      - `email` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)