List Users
GET https://{{axpAPIDomain}}/api/admin/user/v1/accounts/:accountId/jobs/:jobId/users?pageNumber=2&pageSize=5
This API requires the Account Administrator role.
Lists the Users added, updated, or deleted by a job based on the criteria provided.
This includes basic details of each user and current status.
Default ordering is by loginId
, unless specified otherwise via orderBy
.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
pageNumber | number | The page number of the records to retrieve. Default value is 1. | |
pageSize | number | The max number of records to retrieve per page. Default value is 10. |
Any value like 5, 10, 15, 20, 25, 30 is allowed.
Values that exceed the maximum will result in a 400 Bad Request being returned.
|
| filter
| string | | Specifies details of a row filter.
The possible fields you can filter on are:
- firstName
- lastName
- loginId
- status
The allowed format:
- Begins with the column name to be filtered, followed by a colon, then:
- Either an exact string to match, or
- A string expression including the * wildcard character
- :{PREFIX}* will be used to find out word start with.
- :*{POSTFIX} will be used to find out word end with
- : will be used to match exact word
- Begin with column name to be filtered, followed by a = operator. (this will be used to match exact string)
|
|
orderBy
| string | | Field name on which sorting needs to be performed. The default sorting order is ascending.
The possible fields that can be ordered on are:
- firstName
- lastName
- loginId
Field Names are case-sensitive (should be written as it is in description).
To specify descending order, a suffix " desc" should be added. For example, "firstName" for ascending or "firstName desc" for descending". |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
appkey | string | ||
Accept | string |
RESPONSES
status: OK
{"pagination":{"pageNumber":2,"pageSize":10,"total":45},"users":[{"loginId":"something@domain.com","userId":"c8c2909d-75e9-484a-94c0-b7e8d30771ee","operation":"ADD","status":"COMPLETED","message":"User successfully added"},{"loginId":"steves@domain.com","userId":"c7c2909d-75e9-484a-94c0-b7e8d30772dd","operation":"ADD","status":"IN_PROGRESS","message":"Operation is in progress"},{"loginId":"steven@domain.com","userId":"b7c2909d-75e9-484a-94c0-b7e8d30771cc","operation":"ADD","status":"FAILED","message":"Invalid member of group provided"}],"links":{"prev":"/api/admin/user/api/admin/user/v1/accounts/{{accountId}}/jobs/importUserList1/users?pageNumber=1\u0026pageSize=10","next":"/api/admin/user/api/admin/user/v1/accounts/{{accountId}}/jobs/importUserList1/users?pageNumber=3\u0026pageSize=10"}}