Get Account Info by ID

The Get Account Info by ID method returns Account's details by the given Account ID.

GET /api/vendor/v1/accounts/{account_id}.json?api_token={api_token}

Arguments

Name	Parameter Type	Data type	Required/Optional	Description
account_id	path	integer	Required	Account ID
api_token	query	string	Required	API token of the manager who performs the operation (see API Token Authentication)

Response model

Name		Data type	Description
id		integer	Account ID
name		string	Account name
account_class_id		integer	Account class ID (see Account classes)
account_class		string	Account class name (see Account classes)
primary_name		string	Account primary name (a company name, if the customer is a legal entity)
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: active – the Account is available for any possible operation. administrative hold – the Account was blocked by the manager (see Moving an account to the administrative hold). credit hold – the Account was blocked automatically due to the debt on the account balance (see Credit Hold of the Account). You can set the parameters of moving an account to the credit hold in the Account class, to which the account relates (see Account classes). deleted – the Account was deleted by manger (see Deleting an account).
balance		float	A current value of the Account balance (see Viewing the list of charges)
account_type_id		integer	Account type ID
account_type		string	Account type name
default_payment_model		string	Default payment model from the Account class: prepay postpay
current_debt		float	Current debt of the Account for all postpaid Subscriptions
financial_blocking_threshold_use_system		bool	Shows whether the Account uses the default Financial blocking threshold value that is set in the Account class: true – the Account uses the Financial blocking threshold value that is set in the Account class. false – the Account uses the Financial blocking threshold value that is 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
subscription_credit_limit_use_system		bool	Shows whether the Account uses the default Subscription credit limit value that is set in the Account class: true – the Account uses the Subscription credit limit value that is set in the Account class. false – the Account uses the Subscription credit limit value that is redefined on the Account level.
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
manager_id		integer	ID of the manager who is linked with the Account
owner_id		integer	ID of the User who is granted the Owner access rights in the Customer Control Panel
tech_user_id		integer	ID of the user, which is responsible for the technical matters
bill_user_id		integer	ID of the user, which is responsible for the financial matters
custom_attributes		array	A list of additional attributes (see Managing attributes)
	name	string	Attribute name
	value	Depends on the attribute	Attribute value
created_at		date	Date and time of the Account creation
updated_at		date	Date and time, when the Account information was updated

Request example

GET /api/vendor/v1/accounts/431.json?api_token=vY5fwetestK3gJXZH5uHCw

Response example

{
    "id": 431,
    "name": "Jane Lane",
    "account_class_id": 1,
    "account_class": "Default",
    "primary_name": "",
    "first_name": "Jane",
    "middle_name": "",
    "last_name": "Lane",
    "country": "BY",
    "region": "minski",
    "city": "minsk",
    "street": "minsk",
    "building": "",
    "office": "",
    "zip": "220000",
    "phone": "+375291234567",
    "email": "test@example.com",
    "status": "credit_hold",
    "balance": "453.2",
    "account_type_id": 1564,
    "account_type": "Personal",
    "default_payment_model": "prepay",
    "current_debt": 24.0,
    "financial_blocking_threshold_use_system": true,
    "financial_blocking_threshold": 100.0,
    "subscription_credit_limit_use_system": true,
    "subscription_credit_limit": 0.0,
    "manager_id": null,
    "owner_id": 23,
    "new_owner_first_name": null,
    "new_owner_last_name": null,
    "new_owner_middle_name": null,
    "new_owner_email": null,
    "tech_user_id": 23,
    "bill_user_id": 23,
    "custom_attributes": [
        {
            "name": "Personal number",
            "value": "A4411111BB1123"
        },
        {
            "name": "Birth date",
            "value": "10.08.2016"
        },
        {
            "name": "Issued",
            "value": "01.07.2016"
        },
        {
            "name": "Passport number",
            "value": "1124111111123"
        },
        {
            "name": "Issued by",
            "value": "Government"
        }
    ],
    "created_at": "2019-01-15T14:58:22.830+03:00",
    "updated_at": "2019-05-12T01:22:52.853+03:00"
}