List Approvals

GET /v2/policy-approvals

List Approval objects (created if a policy triggered requiring an Approval process action).

• Request headers required. See Request Headers for more information.

• Authentication required. See Authentication Headers for more information.

Required Permissions

Name	Conditions
Policies:Approvals:Read	Always Required

Query parameters

Query param	Required/Optional	Description
limit	Positive Integer -Optional	Maximum number of items to return. Default to 20.
paginationToken	String - Optional	Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.
status	String - Optional	Either Pending, Approved, Denied, AutoApproved or Expired.
triggerStatus	String - Optional	Triggered or Skipped.
initiatorId	String - Optional	The user ID of the activity initiator.
approverId	String - Optional	The user ID of a potential approver.

Response

200 - List of Approval Objects

See Get Approval response for the details of a single approval object

{
  "items":[
    {
      "id":"evl-...",
      ...
    }
  ],
  "nextPageToken":"ZxZ..."
}