Logo
IdentityNow API Documentation

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