On This Page
REST API
Retrieve a List of Users
You can retrieve a list of
Business Center
users within your organization and view
their account information. See Create an API
Request for general information on how to call this API.
Use this resource to retrieve a list of
Business Center
users: - Test:POSThttps://apitest.cybersource.com/ums/v1/users/search
- Live:POSThttps://api.cybersource.com/ums/v1/users/search
- Live in India:POST https://api.in.cybersource.com/ums/v1/users/search
For a detailed API reference, see the Search User Information section of the interactive API Reference.
Request
To retrieve a list of
Business Center
users who are in your organization, you must pass
one of the following fields or field combinations:- organizationId
- userName
- userNamewithorganizationId
- roleIdwithorganizationId
- permissionIdwithorganizationId
Field | Description |
---|---|
organizationId | (Conditional) The organization ID of the
user(s). This can be the merchant ID, account ID, or reseller ID. You can pass
this field only or pass it with one of the other request fields. |
userName | ( Conditional) The specific user name of the
user you want to view. You can pass this field only or pass it with the
organizationId field. |
permissionId | (Conditional) Pass this field with the
organizationId field to filter your search results to a
specific permission. |
roleId | (Conditional) Pass this field with the
organizationId field to filter your search results to a
specific user role. |
Request example:
The following request searches for all admin users within the Global Art Supplies, Inc.
organization.
{ "organizationId": "GlobalArtSupplies", "roleId": "Admin" }
Response
A successful response returns a
users
array with one or more
user
objects. Each user object consists of the following objects:
- accountInformation- Includes the fields:userName,roleId,permissions,status,createdTime,lastAccessTime,languagePreference, andtimezone.
- The user accountstatusfield can have one of the following values:active,inactive,locked,disabled,forgotpassword, anddeleted.
- organizationInformation- Includes the field:organizationId.
- contactInformation- Includes the fields:email,phoneNumber,firstName, andlastName.
- customFieldscreated by your organization
Response example:
The following response lists admin users within the Global Art Supplies, Inc. organization.
{ "users": [ { "accountInformation": { "userName": "minajon", "roleId": "Admin", "permissions": [ "ReportViewPermission", "ReportGeneratePermission" ], "status": "active", "createdTime": "2020-06-14T19:45:52.093Z", "lastAccessTime": "2021-03-14T19:45:52.093Z", "languagePreference": "en-US", "timezone": "America/Los_Angeles" }, "organizationInformation": { "organizationId": "GlobalArtSupplies" }, "contactInformation": { "email": "[email protected]", "phoneNumber": "3105551212", "firstName": "Mina", "lastName": "Jon" }, "customFields": { "employeeId": "007", "jobTitle": "Sales Director", "department": "Sales" } } ] }