GuidesAPI ReferenceRecipes
API Reference
Request a Demo

Retrieve the Approval Requests on a Workflow

get
https://na1.ironcladapp.com/public/api/v1/workflows//approval-requests

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

OAuth Scope required: public.workflows.readApprovals

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier or Ironclad ID of a workflow.

Query Params
int32
0 to 100000000
Defaults to 0

The page number used when paginating through a list of results.

int32
1 to 100
Defaults to 20

A limit of the number of results to return.

boolean
Defaults to false

An optional boolean parameter that adds additional information about the actor to each item in the response. Defaults to false.

string
enum
Defaults to user

An optional string parameter that specifies the type of approval requests and returns approval requests by role or user.

Allowed:
Headers
string

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-id is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

string

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-email is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

Responses

Updated 10 days ago

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 10 days ago