---
title: "Retrieve the Approval Requests on a Workflow"
method: GET
path: "/workflows/{id}/approval-requests"
tags: ["Workflows"]
---

# Retrieve the Approval Requests on a Workflow

`GET /workflows/{id}/approval-requests`

Returns a list of approval requests that have taken place on the workflow. 

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

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `pageSize` integer
- `actorDetails` boolean
- `requestType` 'role' | 'user'

## Headers

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

## Response `200`

200

- object
  - `page` integer
  - `pageSize` integer
  - `count` integer
  - `list` object[] — Approval requests on a workflow
    - `startTime` string — Timestamp when the approval request became available for review
    - `endTime` string — Timestamp when the approval request was approved or interrupted by workflow actions
    - `status` 'Approved' | 'Pending' | 'Workflow Paused' | 'Workflow Canceled' | 'Approver Removed' | 'Approver Reassigned' — Current state of an approval request that indicates whether the request is approved, in progress, or affected by workflow actions.
    - `actorId` string — User ID to whom the approval request is assigned to
    - `actorType` 'User'
    - `actorDetails` object
      - `userName` string
      - `userEmail` string
    - `role` string — Role ID of the role assigned to the user for the approval request
    - `roleName` string — Display name of the role assigned to the user for the approval request
    - `duration` integer — Duration of the completed approval request in milliseconds
    - `aggregateDuration` integer — Total duration of the completed approval request, obtained by adding the duration of the approved request with the durations of preceding requests (if any) where the approver was able to review but interrupted by a workflow pause.
    - `approvalType` 'Workflow'

## Other responses

- `403` — 403
- `404` — 404

---

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