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
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 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 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 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
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
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"}}}]