Get Reseller by ID (Customer Store)

The Get Reseller by ID (Customer Store) method requires installed Customer Store (see Managing Storefront).

For getting information about the current Reseller or any of its downstream Resellers, the Get downstream Reseller information by ID method can also be used (see Get downstream Reseller information by ID).

The Get Reseller by ID (Customer Store) 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

Name			Data type	Description
id			string	Reseller ID
type			string	Data type
attributes			object	Reseller information
	parent_id		string	Upstream (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 alpha-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

GET /api/v3/customer_store/resellers/1
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetest3gJXZH5uHCw
Accept: application/vnd.api+json

Response example

{
    "data": {
        "id": "1",
        "type": "resellers",
        "attributes": {
            "created_at": "2016-08-25T09:26:12.491+03:00",
            "updated_at": "2020-01-16T13:10:53.572+03:00",
            "parent_id": 27,
            "general": {
                "created_at": "2016-08-25T09:26:12.491+03:00",
                "updated_at": "2020-01-16T13:10:53.572+03:00",
                "name": "SL SP Root",
                "domain": "test.activeplatform.com",
                "manager": "Alena Rataeva",
                "currency": "BYN"
            },
            "company": {
                "created_at": "2016-08-25T09:26:12.491+03:00",
                "updated_at": "2020-01-16T13:10:53.572+03:00",
                "city": "Минск",
                "zip": "220053",
                "country": "BY",
                "fax": "",
                "name": "SL SP Root",
                "address_line_1": "Гаяяяя",
                "address_line_2": "Гаяяяяя",
                "state": "Минская",
                "phone": "+375252222060",
                "email": "example@gmail.com"
            },
            "contacts": {
                "created_at": "2016-08-25T09:26:12.491+03:00",
                "updated_at": "2020-01-16T13:10:53.572+03:00",
                "first_name": "Ivan",
                "last_name": "Ivanov",
                "middle_name": "",
                "position": "",
                "phone": "+375252222060",
                "email": "aaaa@example.ru"
            },
            "custom_attributes": {
                "inn": "",
                "email": "",
                "l": ""
            }
        }
    }
}