The Get account method returns account details for the current reseller or any of its downstream resellers.
GET {base_url}/api/v3/resellers/{reseller_id}/accounts/{account_id}
Arguments
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:
|
||
|
|
|
|
string |
Email of the contract person |
||
|
|
|
status |
string |
|||
|
|
|
balance |
string |
Total account balance as a sum of available funds (see |
||
|
|
|
usable_balance |
string |
Available funds on the 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 (см.
) |
||
|
|
|
manager_id |
integer |
Account's manager ID |
||
|
|
|
owner_id |
integer |
Account's Owner ID |
||
|
|
|
tech_user_id |
integer |
|||
|
|
|
bill_user_id |
integer |
ID of the account's гser selected as Billing contact (see
) |
||
|
|
|
custom_attributes |
object |
|||
|
|
|
|
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:
|
|
|
|
|
|
|
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
) |
|
|
|
|
|
custom_attributes |
array |
The list of the manager's additional attributes (see
) |
|
|
|
|
|
|
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 |
|
|
|
|
|
|
string |
Email of the account's Owner |
|
|
|
|
|
account_status |
string |
Account's Owner status for the account (for information about statues, see
) |
|
|
|
|
|
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 |
|
|
|
|
account_product_managers |
array of objects |
Responsible managers of the account (see
) |
||
|
|
|
|
id |
integer |
ID of information about the responsible manager |
|
|
|
|
|
account_id |
integer |
Account ID |
|
|
|
|
|
product_id |
integer |
Product ID |
|
|
|
|
|
responsible_product_manager_id |
integer |
Responsible manager ID within the product |
|
|
|
|
|
manager_product_role_id |
integer |
Manager role ID within the product |
|
|
|
|
|
created_at |
date |
Date and time when information about the responsible manager was created |
|
|
|
|
|
updated_at |
date |
Date and time when information about the responsible manager was updated |
|
|
|
|
self_registration |
bool |
Indicates whether the account was created by completing the self-registration process in the Customer Control Panel:
|
||
|
|
|
default_payment_model |
string |
Default payment model:
|
||
|
|
|
account_type |
object |
Information about the account type (see
) |
||
|
|
|
|
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
) |
|
|
|
|
|
ancestry |
string |
ID of the parent account type |
|
|
|
|
account_class |
string |
Information about the account class (see
) |
||
|
|
|
|
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 status (for the list of the available types of the subscription stopping, see
) |
|
|
|
|
|
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
) 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
) |
|
|
|
|
|
denominated |
bool |
Attribute of the account type denomination:
|
|
|
|
|
|
buy_with_negative_balance |
bool |
Availability of paying for orders with the negative account balance (for the Prepay payment model):
|
|
|
|
|
|
receipt_day |
integer |
Deprecated |
|
|
|
|
|
payment_model |
string |
Payment model:
|
|
|
|
|
|
default |
bool |
Default account type for 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": "minsk",
"city": "minsk",
"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"
},
"account_product_managers": [
{
"id": 431,
"account_id": 710,
"product_id": 400,
"responsible_product_manager_id": 3,
"manager_product_role_id": 2,
"created_at": "2020-12-09T06:15:52.348+03:00",
"updated_at": "2020-12-16T15:38:56.541+03:00"
},
{
"id": 9,
"account_id": 710,
"product_id": 400,
"responsible_product_manager_id": 1,
"manager_product_role_id": 1,
"created_at": "2020-12-09T06:13:40.744+03:00",
"updated_at": "2020-12-16T15:38:56.533+03:00"
}
],
"self_registration": false,
"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"
}
]
}
}
}
}