Get List of Non-Employee Approval Requests
GET {{baseUrl}}/non-employee-approvals
This gets a list of non-employee approval requests.
There are two contextual uses for this endpoint:
1. The user has the role context of idn:nesr:read
, in which case they
can list the approvals for any approver.
2. The user owns the requested approval.
Body
PARAM
Key | Datatype | Required | Description |
requested-for
|
string | The identity for whom the request was made. *me* indicates the current user. | |
limit
|
number | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. | |
offset
|
number | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. | |
count
|
boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. | |
filters
|
string | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **approvalStatus**: *eq* | |
sorters
|
string | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **created, modified** |
HEADERS
Key | Curl curl -X GET 'https://tenant.api.identitynow.com/v3/non-employee-approvals?requested-for=2c91808280430dfb0180431a59440460&limit=250&offset=0&count=true&filters=approvalStatus eq "Pending"&sorters=created' -H 'Accept: application/json' ENDPOINTS |