Use this endpoint to retrieve a list of User Profiles matching the search keyword provided in the request parameter. Do not enter your search term wrapped in quotation marks. Provided keyword will be matched against the user attributes case insensitively - First Name, Last Name, Friendly Name, Username, Email, Phone, Company, Contact, Country, Status, Group Names, and Role Name. Entering "*" as your search term will return all users. The response is formatted as an area of objects, with each user account being returned as an object, as well as a key called 'count', which indicates how many accounts met the search critera. A maximum limit of 100 accounts will be returned in the response. In the case that more than 100 accounts meet the search criteria, pagination using the optional 'from' and 'limit' query parameters will be required to retrieve all accounts.
The user performing this action must have the 'User Management' role privilege.
How to use pagination: Pagination should be used when the amount of user accounts that match the entered search term exceeds the amount of users (100) returned in a single response. Paginating through the results will require making more than one call to this endpoint. To retrieve the first 100 users, in your query parameters, set your 'from' value to 0, and your 'limit' value to 100. To return the next set of 100 users, leave your 'limit' value as 100, but set your 'from' value to 100.
Continue to repeat this process of adding 100 to your 'from' value until all user account results are captured.
The Response Body will be a JSON object
Unauthorized. Missing Authorization or AccessToken or Access Token expired
Forbidden. Missing X-API-key
{- "status": "success",
- "data": [
- {
- "userId": "7d675ef0-f423-11e9-8071-89c0c4052141",
- "customerId": "1234567890",
- "emailId": "erlich.bachman@piedpiper.com",
- "firstName": "Erlich",
- "lastName": "Bachman",
- "roleId": "7d5620e0-f423-11e9-8071-89c0c4052141",
- "status": "enabled",
- "groups": [
- "7d6207c0-f423-11e9-8071-89c0c4052141"
], - "userName": "erlich.bachman",
- "phone": 15551234565,
- "contact": "Richard Hendricks",
- "country": "USA",
- "company": "Pied Piper",
- "friendlyName": "Erlich Bachman"
}
]
}