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.

Request Params

KeyDatatypeRequiredDescription
requested-forstringThe identity for whom the request was made. me indicates the current user.
limitnumberMax number of results to return.
See V3 API Standard Collection Parameters for more information.
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results.
See V3 API Standard Collection Parameters for more information.
countbooleanIf 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 for more information. | | filters | string | | Filter results using the standard syntax described in V3 API Standard Collection Parameters

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

Sorting is supported for the following fields: created, modified |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

[{"id":"2c1e388b-1e55-4b0a-ab5c-897f1204159c","approver":{"type":"IDENTITY","id":"5168015d32f890ca15812c9180835d2e"},"accountName":"test.account","approvalStatus":"APPROVED","approvalOrder":1,"comment":"I approve","modified":"2019-08-23T18:52:59.162Z","created":"2019-08-23T18:40:35.772Z","nonEmployeeRequest":{"id":"ac110005-7156-1150-8171-5b292e3e0084","requester":{"type":"IDENTITY","name":"William Smith"}}},{"id":"2c1e388b-1e55-4b0a-ab5c-897f1204159c","approver":{"type":"IDENTITY","id":"5168015d32f890ca15812c9180835d2e"},"accountName":"test.account","approvalStatus":"APPROVED","approvalOrder":1,"comment":"I approve","modified":"2019-08-23T18:52:59.162Z","created":"2019-08-23T18:40:35.772Z","nonEmployeeRequest":{"id":"ac110005-7156-1150-8171-5b292e3e0084","requester":{"type":"IDENTITY","name":"William Smith"}}}]