There are two API methods to get information about a downstream Reseller:

Get downline Reseller information by ID
GET {base_url}/api/v3/resellers/{reseller_id}
Get Reseller by ID
GET {base_url}/customer_store/resellers/{reseller_id}

Each method returns the same response with information about the selected downstream Reseller.

The Get downline Reseller information by ID method doesn't require the Customer Store module, while the Get Reseller by ID method requires installed Customer Store (see Managing Storefront).

Get downline Reseller information by ID

The Get downline Reseller information by ID method returns information about the current Reseller or about any of its downstream Resellers.

Access to the current Reseller and downstream Resellers is determined by the Manager's token in the API request.

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

Arguments

Name	Parameter type	Data type	Required/Optional	Description
X-Api-Token	header	string	Required	API token of the Manager that performs the operation (see Viewing and updating manager's information)
Content-Type	header	string	Required	Indicates the media type (text/html or text/JSON) of the response that is sent to the client by the server
Accept	header	string	Required	Information about data types that the client (browser) supports
reseller_id	path	integer	Required	ID of the current Reseller or any of its downstream Resellers (see Viewing and updating reseller general information)

Response model

See below the response model of the Get Reseller by ID method.

Request example

GET http://reseller.activeplatform.com/api/v3/resellers/1 
 
Accept: application/vnd.api+json
Content-Type: application/vnd.api+json
X-Api-Token:qQwW12

Response example

See below the response example of the Get Reseller by ID method.

Get Reseller by ID

The Get Reseller by ID method returns information about selected downstream Reseller.

Access to the current Reseller and downstream Resellers is determined by the Manager's token in the API request.

GET {base_url}/customer_store/resellers/{reseller_id}

Arguments

Name	Parameter type	Data type	Required/Optional	Description
reseller_id	path	integer	Required	ID of the current Reseller or any of its downline Resellers (see Viewing and updating reseller general information
api_token	query	string	Required	API token of the Manager that performs the operation (see Viewing and updating manager's information)

Response model

Name			Data type	Description
id			string	Reseller ID
type			string	Data type
attributes			object	Reseller information
	parent-id		string	Upline (parent) Reseller ID
	created-at		date	Date and time of the Reseller creation
	updated-at		date	Date and time of the last update of the Reseller information
	general		object	Model of the general information about the Reseller
		name	string	Reseller name
		domain	string	Reseller domain
		currency	string	Reseller currency in the ISO 4217 alfa-3 format
		manager	string	Manager that is attached to the Reseller
	company		object	Model of the information about the Reseller company
		name	string	Company name
		address-line-1	string	First line of the company address
		address-line-2	string	Second line of the company address
		city	string	City, in which the company is situated
		state	string	State, in which the company is situated
		zip	string	Zip-code of the company
		country	string	Company country code according to ISO 3166-1 alpha-2 standard
		phone	string	Phone number of the company: + < country code > < city code or network code > < phone number > 00 < country code > < city code or network code > < phone number >
		fax	string	Company fax number
		email	string	Company email
	contacts		object	Information about Reseller contact person
		first-name	string	First name of the company contact person
		last-name	string	Last name of the company contact person
		middle-name	string	Middle name of the company contact person
		position	string	Position of the company contact person
		phone	string	Phone number of the company contact person: + < country code > < city code or network code > < phone number > 00 < country code > < city code or network code > < phone number >
		email	string	Company contact person's email
	attributes.custom-attributes		object	Reseller Attributes
		attributes.custom-attributes['custom-attribute-key']	string	Reseller Attribute value

Request example

curl -X GET -H "Content-Type: application/vnd.api+json" -H "Accept: application/vnd.api+json" -H "X-Api-Token: G2dYuBK44dgYu90id1122e" http://billing.activeplatform.com/api/v3/customer_store/resellers/1

Response example

{
    "data": {
        "id": "1",
            "type": "resellers",
            "attributes": {
                "created-at": "2017-06-09T15:44:51.694+03:00",
                "updated-at": "2017-12-22T16:38:53.600+03:00",
                "parent-id": 1,
                "general": {
                    "name": "Company 1",
                    "domain": "cn1.billing.activeplatform.com",
                    "manager": "Manager 1",
                    "currency": "USD"
                },
                "company": {
                    "name": "Company name 1",
                    "address-line-1": "Nezalezhnosty av., 1",
                    "address-line-2": "Sovietsky distr.",
                    "city": "Minsk",
                    "state": "Minskaya",
                    "zip": "220000",
                    "country": "BY",
                    "fax": "+375170345678",
                    "phone": "+375290468624",
                    "email": "company@example.com"
                },
                "contacts": {
                    "first-name": "Ivan",
                    "last-name": "Petrov",
                    "middle-name": "Ivanovich",
                    "position": "Sales representative",
                    "phone": "+375290468624",
                    "email": "petrov.company@example.com"
                },
                "custom-attributes": {
                    "1c password ": "password",
                    "1c api name ": "1c api",
                    "kpp": "234342617111",
                    "inn": "23411113234",
                    "reseller pin": "1234"
            }
        }
    }
}