List Users
GET https://{{axpAPIDomain}}/api/admin/user/v1/accounts/:accountId/users?pageNumber=2&pageSize=5
This API requires the Account Administrator role.
Lists all of the users for an account.
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. | |
filter | string | Specifies details of a row filter. |
The possible fields that can be filtered on are:
- loginId
- lastName
- firstName
- emailId
- organizationNodeId
- profileId
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 ordering needs to be performed. The default order is ascending.
The possible fields that can be ordered on are:
- loginId
- lastName
- firstName
- emailId
- organizationNodeId
Field Names are case-senstive (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":[{"organizationNodeId":"EXMPLE","userId":"c8c2909d-75e9-484a-94c0-b7e8d29771fe","loginId":"stevens@avaya.com","lastName":"Stevens","firstName":"Alex","displayName":"Stevens, Alex","emailId":"stevens@avaya.com","profileId":"FSADSJ","memberOfGroups":["c8c2909d-75e9-484a-94c0-b7e8d29771fe"],"ownedGroups":["a8b6d39c-53c5-4d94-a640-c28bee987ed7"],"roles":["Agent"],"addresses":[{"addressId":"c8c2909d-75e9-484a-94c0-b7e8d29771fe","addressName":"Address Name","addressType":"OFFICE","addressTypeNumber":"101","streetNumber":"A11","streetName":"Allstate Pkwy","city":"Markham","state":"ON","countryCode":"ZW","zip":"L3R9T8","isDefault":false}],"accountAddresses":[{"addressId":"c8c2909d-75e9-484a-94c0-b7e8d29771fe","isDefault":false}],"features":{"matching":{"attributes":["Language.English","Language.French"],"queues":[{"queueId":"620bbb28-7112-433a-af59-17ee0f15a247","proficiency":10},{"queueId":"07d2c0a3-f05c-47e7-a86e-51148d3d4fd4","proficiency":6}]},"chat":{"autoAnswer":false,"multiplicity":2,"afterContactWork":false,"providers":[{"providerAgentId":"stevens@avaya.com","channelProviderId":"d7c2909d-75e9-484a-94c0-b7e8d30771dd"}]},"messaging":{"autoAnswer":false,"multiplicity":2,"afterContactWork":false,"providers":[{"providerAgentId":"stevens@avaya.com","channelProviderId":"d7c2909d-75e9-484a-94c0-b7e8d30771dd"}]},"email":{"autoAnswer":false,"multiplicity":2,"afterContactWork":false,"providers":[{"providerAgentId":"stevens@avaya.com","channelProviderId":"d7c2909d-75e9-484a-94c0-b7e8d30771dd"}]},"voice":{"autoAnswer":false,"afterContactWork":false,"userExtension":"10021","emergencyLocationIdentificationNumber":"7798098090","providers":[{"providerAgentId":"stevens@avaya.com","channelProviderId":"d7c2909d-75e9-484a-94c0-b7e8d30771dd"}]},"cmvoice":{"agentLoginId":11021,"agentPassword":81238,"extensionNumber":1111,"communicationProfileAddresses":[{"address":"10022@SipDomain1.com","type":"SIP","isDefault":true},{"address":"+12345@avaya.com","type":"E164","isDefault":false}],"communicationProfilePassword":"anypasswordstring"},"aci":{},"recorder":{},"outbound":{}}}],"links":{"prev":"/api/admin/user/v1/accounts/ASDJGE/users?pageNumber=1\u0026pageSize=10","next":"/api/admin/user/v1/accounts/ASDJGE/users?pageNumber=3\u0026pageSize=10"}}