Get the Reseller's Account Information by ID

The Get the Reseller's Account by ID method returns Account details by the given Account ID of the current Reseller or 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}/accounts/{account_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 request that is sent to the server by the client (browser)
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)
account_id	path	integer	Required	ID of the Account

Response model

Name					Data type	Description
data					object	Response data
	id				integer	Account ID
	type				string	Data type
	attributes				object	Account information
		created_at			date	Date and time of Account creation
		updated_at			date	Data and time of Account last update
		reseller_id			integer	ID of the Account's Reseller
		name			string	Account name
		account_class_id			integer	Account Class ID
		primary_name			string	Primary name of the Account. For example, a company name
		first_name			string	The first name of the contract person
		middle_name			string	The middle name of the contract person
		last_name			string	The last name of the contract person
		country			string	Contact information: a two-letter ISO code ISO 3166-1 alpha-2 of the country
		region			string	Contact information: Region
		city			string	Contact information: City
		street			string	Contact information: Street
		building			string	Contact information: Building
		office			string	Contact information: Office
		zip			string	Contact information: Zip-code
		phone			string	Contact information: Phone number: + < country code > < city code or network code > < phone number > 00 < country code > < city code or network code > < phone number >
		email			string	Email of the contract person
		status			string	Account status (see Viewing and updating account's details for the list of statuses)
		balance			float	Account balance
		current_debt			float	Current debt of the Account for all postpaid Subscriptions
		subscription_credit_limit			float	The value of the Subscription credit limit for the Account that is set in the Account class or redefined on the Account level
		financial_blocking_threshold			float	The value of the Financial blocking threshold for the Account that is set in the Account class or redefined on the Account level
		account_type_id			integer	Account Type ID (см. Viewing the list of account types)
		manager_id			integer	Account's Manager ID
		owner_id			integer	Account's Owner ID
		tech_user_id			integer	ID of the Account's User selected as Tech contact (see Viewing and updating account's details)
		bill_user_id			integer	ID of the Account's User selected as Billing contact (see Viewing and updating account's details)
		custom_attributes			object	Account Attributes (see Managing attributes)
			attributes.custom-attributes['custom-attribute-key']		string	Account Attribute value
		manager			array	Information about the Account's Manager
			created_at		date	Date and time of the Manager creation
			updated_at		date	Data and time of the Manager last update
			reseller_id		integer	ID of the Manager's Reseller
			id		integer	ID of the Manager
			name		string	Name of the Manager
			status		string	Status of the Manager: active — access to the Operator Control Panel is allowed inactive — access to the Operator Control Panel is blocked
			email		string	Manager's email which is used as a login to the Operator Control Panel
			role		string	Manager's role (for the list of roles, see Managers' roles)
			custom_attributes		array	The list of the Manager's additional attributes (see Viewing the List of Attributes)
				manager.custom-attributes['custom-attribute-key']	string	The value of the Attribute
		owner			object	information about the Owner of the Account
			created_at		string	Date and time of Account's Owner creation
			updated_at		string	Date and time of Account's Owner last update
			email		string	Email of the Account's Owner
			account_status		string	Account's Owner status for the Account (for information about statues, see Managing account's users)
			global_status		string	Account's Owner status in ActivePlatform
			first_name		string	The first name of the Account's Owner
			middle_name		string	The middle name of the Account's Owner
			ast_name		string	The last name of the Account's Owner
		default_payment_model			string	Default payment model: postpay prepay
		account_type			object	Information about the Account Type (see Viewing the list of account types)
			id		integer	ID of the Account Type
			name		string	Name of the Account Type
			created_at		date	Date and time of the Account Type creation
			updated_at		date	Date and time when the Account Type was updated
			reseller_id		integer	ID of the Reseller linked to the Account type
			name_pattern		string	Template of the Account type name which is displayed in the platform
			primary_name		string	Name of the field with the primary name of the Account. For example, for the Business Account Type, the filed may be named as Company name
			key		string	Key that is used to refer to the Account Type by API or a Placeholder
			default_payment_method_id		integer	ID of the default Payment method (see Configuring payment methods)
			ancestry		string	ID of the parent Account Type
		account_class			string	Information about the Account Class (see Viewing the list of account classes)
			id		integer	ID of the Account Class
			reseller_id		integer	ID of the linked Reseller
			name		string	Name of the Account Class
			created_at		date	Date and time of the Account Type creation
			updated_at		date	Date and time when the Account Type was updated
			financial_blocking_threshold		float	The value of the Financial blocking threshold that is set in the Account class
			due_order_period		integer	Number of days to pay for an Order before the Order becomes canceled (for the prepay payment model)
			subzero_period		integer	Number of days during which the Account balance can be negative without moving the Account to the Credit hold status. The "-1" value refers to the unlimited period
			stop_subscription_type		string	Type of the Subscription stopping if the Account is moved to the Credit Hold (for the list of the available types of the Subscription stopping, see Creating an account class)
			key		string	Key that is used to refer to the Account Class by API or Placeholders
			color		string	Color that is used in the List of Accounts (see Viewing the list of accounts) for this Account Type
			guaranteed_payment_limit		integer	Maximum amount of the Guaranteed Payment that all Accounts, which are added to the Account Class, can use
			guaranteed_payment_period		integer	Number of days, during which all Accounts, which are added to the Account Class, can use the Guaranteed Payments
			delete_subscription_type		string	Type of the Subscription deleting (for the list of the available types of the Subscription deleting, see Creating an account class)
			denominated		bool	Attribute of the Account Type denomination: false — the Account Type is not denominated true — the Account Type is denominated
			buy_with_negative_balance		bool	Availability of paying for Orders with the negative Account Balance (for the prepay payment model): false — paying for Orders with the negative Account Balance is not available true — paying for Orders with the negative Account Balance is available
			receipt_day		integer	Deprecated
			payment_model		string	Payment model: postpay prepay
			default		bool	Default Account Type for new Accounts: false — the Account Type is not applied to new Accounts true — the Account Type is applied to new Accounts
			due_payment_period		integer	Number of days to pay for a Payment before the Payment becomes expired (for the postpay payment model)
			subscription_credit_limit		float	The value of the Subscription credit limit that is set in the Account class
	relationships				object	Information about the related objects
		subscriptions			object	Information about the related Subscriptions
			data		array	Information about the Subscription
				id	integer	ID of the Subscription
				type	string	Data type

Request example

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

Response example

{
    "data": {
        "id": "505",
        "type": "accounts",
        "attributes": {
            "created_at": "2019-10-15T13:08:36.440+03:00",
            "updated_at": "2020-07-07T11:06:27.264+03:00",
            "reseller_id": 1,
            "name": "Marcelo  Ivanou",
            "account_class_id": 1,
            "primary_name": "Test api doc",
            "first_name": "Marcelo",
            "middle_name": "",
            "last_name": "Ivanou",
            "country": "BY",
            "region": "Минская область",
            "city": "Минск",
            "street": "Lenina",
            "building": "1",
            "office": "",
            "zip": "220007",
            "phone": "+375295555555",
            "email": "test@example.com",
            "status": "active",
            "balance": "380.39",
            "usable_balance": "380.39",
            "current_debt": 0.0,
            "subscription_credit_limit": 11000.0,
            "financial_blocking_threshold": 0.0,
            "account_type_id": 1,
            "manager_id": 50,
            "owner_id": 874,
            "tech_user_id": 874,
            "bill_user_id": 874,
            "custom_attributes": {
                "birth_date": "10.08.2016",
                "dns": "",
                "invoice": "",
                "passport_date_of_issue": "01.07.2016",
                "passport_issued_by": "Goverment",
                "passport_number": "1124111111122",
                "personal_number": "A4411111BB1199"
            },
            "manager": {
                "created_at": "2016-11-30T13:16:27.169+03:00",
                "updated_at": "2019-11-22T14:13:28.970+03:00",
                "reseller_id": 1,
                "id": 50,
                "name": "Sales Manager",
                "status": "active",
                "email": "test@gmail.com",
                "role": "sales",
                "custom_attributes": {
                        "ManagerString": "Test"
                    }
            },
            "owner": {
                "created_at": "2016-10-26T17:38:37.551+03:00",
                "updated_at": "2016-12-23T15:04:48.172+03:00",
                "email": "owner@example.by",
                "account_status": "active",
                "global_status": "active",
                "first_name": "Alex",
                "middle_name": "",
                "last_name": "Owner"
            },
            "default_payment_model": "postpay",
            "account_type": {
                "id": 1,
                "name": "Personal BLR",
                "created_at": "2016-08-25T09:26:12.658+03:00",
                "updated_at": "2021-03-04T06:12:01.425+03:00",
                "reseller_id": 1,
                "name_pattern": "%first_name %middle_name %last_name",
                "primary_name": "",
                "key": "personalblr",
                "default_payment_method_id": 2,
                "ancestry": null,
                "use_by_default": true
            },
            "account_class": {
                "id": 1,
                "reseller_id": 1,
                "name": "Default",
                "created_at": "2016-08-25T09:26:12.820+03:00",
                "updated_at": "2020-09-05T10:29:21.844+03:00",
                "financial_blocking_threshold": "0.0",
                "due_order_period": 90,
                "subzero_period": 0,
                "stop_subscription_type": "automatically",
                "key": "default",
                "color": "grey",
                "guaranteed_payment_limit": 1000,
                "guaranteed_payment_period": 7,
                "delete_subscription_type": "automatically",
                "denominated": false,
                "buy_with_negative_balance": false,
                "receipt_day": null,
                "payment_model": "postpay",
                "default": true,
                "due_payment_period": 3,
                "subscription_credit_limit": "222.0"
            }
        },
        "relationships": {
            "subscriptions": {
                "data": [
                    {
                        "id": "3005863",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005862",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005749",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005691",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3006017",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005871",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005868",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3006016",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005870",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005869",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005867",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005865",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005875",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005866",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005864",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3005861",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3006034",
                        "type": "subscriptions"
                    }
                ]
            }
        }
    }
}