Get list of managers

The Get list of managers method returns the list of managers of the current reseller or any of its downstream resellers.

An API token of a manager is required for authorization. To get an API token via the Operator Control Panel, see Viewing and updating Manager's information

The manager's API token specified in an API request determines:

  • The role and access level of the manager, which determine the availability of a method.
  • The current reseller and downstream resellers accessible within a method.

GET {base_url}/api/v3/resellers/{reseller_id}/managers

Arguments

Name

Parameter Type

Data type

Required/ Optional

Description

X-Api-TokenheaderstringRequiredAPI token of a manager that performs the operation (see Viewing and updating Manager's information)
Content-TypeheaderstringRequiredMedia type of the request. Specify the following: application/vnd.api+json
AcceptheaderstringRequired

Supported media types of the answer. Specify the following: application/vnd.api+json

base_urlpathstringRequiredActivePlatform URL
reseller_idpathintegerRequiredID of the current reseller or any of its downstream resellers (see Viewing and updating Reseller general information)
page[size]queryintegerOptionalPage navigation: number of elements per page. The default value is 50
page[number]queryintegerOptionalPage navigation: page number

Response model

Name

Data type

Description

dataarray of objectsResponse data


id

stringID of the manager

typestringData type

attributesobjectInformation about the manager


created_at

stringDate and time of the manager creation


updated_at

stringDate and time when the manager was updated


reseller_idintegerID of the reseller


namestringManager's name


statusstring

Status of the manager:

  • active — access to the Operator Control Panel is allowed.
  • inactive — access to the Operator Control Panel is blocked.


emailstringManager's email which is used as a login to the Operator Control Panel


rolestringManager's role (for the list of roles, see Managers' Roles)


manager_roleobjectInformation about the manager's access level (see Managing access levels) if the role is not System administrator



idintegerThe access level ID



namestringThe access level name


phonestring

Manager's phone number:

  • + < country code > < city code or network code > < phone number >.
  • 00 < country code > < city code or network code > < phone number >.


photostringLink to the file of the manager's photo


manager_keystring

Unique manager's key

This key allows linking an Account to a Manager (see Viewing and updating an Account's details) automatically when a customer orders a new Service via Customer Store with a special URL parameter (see Buy-link template for ordering a Service via Storefront). The key can include uppercase and lowercase characters, numbers, underscore, dot, and dash. The key is case-sensitive, so it is important to specify it in a buy-link exactly as on the manager information page. For example, carter81 and Carter81 are different keys, and they will not work together.



mfa_requiredboolThe multi-factor authentication (MFA) status of a manager (see Viewing and updating Manager's information):
  • true — the MFA status is Active.
  • false — the MFA status is Inactive.


custom_attributesobject

Manager's attributes (see Viewing the List of Attributes)




['custom_attribute_key']stringManager's attribute value for the specified attribute key
linksobjectPage navigation links that use the defined page navigation parameters

selfstringCurrent page link

firststringFirst page link

prevstringPrevious page link

nextstringNext page link

laststringLast page link

Request example

GET /api/v3/resellers/1/managers?page[size]=2&page[number]=48
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example

{
    "data": [
        {
            "id": "431",
            "type": "managers",
            "attributes": {
                "created_at": "2021-01-05T05:28:48.804+03:00",
                "updated_at": "2021-01-05T06:23:10.815+03:00",
                "reseller_id": 1,
                "name": "Brendon Leannon",
                "status": "active",
                "email": "carter81@example.net",
                "role": "admin",
                "manager_role": {
                    "id": null,
                    "name": null
                },
                "phone": "+375280000000",
                "photo": "/images/manager/431/manager.png",
                "manager_key": "",
                "mfa_required": true, 
                "custom_attributes": {
                    "manager_1c_identifier": ""
                }
            }
        },
        {
            "id": "432",
            "type": "managers",
            "attributes": {
                "created_at": "2021-01-08T21:33:32.789+03:00",
                "updated_at": "2021-01-08T21:34:29.005+03:00",
                "reseller_id": 1,
                "name": "Trycia Corwin",
                "status": "active",
                "email": "tryciacorwin71@example.net",
                "role": "sales",
                "manager_role": {
                    "id": 1,
                    "name": "Access Level 1"
                },
                "phone": "+375270000000",
                "photo": "/images/manager/432/432.jpg",
                "manager_key": "",
                "mfa_required": true, 
                "custom_attributes": {
                    "manager_1c_identifier": "20"
                }
            }
        }
    ],
    "links": {
        "self": "https://test.activeplatform.com/api/v3/resellers/1/managers?page%5Bnumber%5D=48&page%5Bsize%5D=2",
        "first": "https://test.activeplatform.com/api/v3/resellers/1/managers?page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "prev": "https://test.activeplatform.com/api/v3/resellers/1/managers?page%5Bnumber%5D=47&page%5Bsize%5D=2",
        "next": null,
        "last": "https://test.activeplatform.com/api/v3/resellers/1/managers?page%5Bnumber%5D=48&page%5Bsize%5D=2"
    }
}