Get Account Info by ID

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

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

Arguments

Name	Parameter Type	Data type	Required/Optional	Description
id	path	integer	Required	An account ID.
api_token	query	string	Required	API token of the manager who perform the operation (see API Token Authentication).

Response model

Name	Data type	Description
id	integer	An account ID.
name	string	An account name.
account_class_id	integer	An account class ID (see Account classes in the ActivePlatform. Operator Control Panel).
account_class	string	A name of the account class (see Account classes in the ActivePlatform. Operator Control Panel).
primary_name	string	A company name, if the customer is a legal entity.
first_name	string	The first name for the user the owner access rights.
middle_name	string	The middle name for the user the owner access rights.
last_name	string	The last name for the user the owner access rights.
country	string	An account address: a two-letter ISO code ISO 3166-1 alpha-2 of the country.
region	string	An account address: a region.
city	string	An account address: a city.
street	string	An account address: a street.
building	string	An account address: building.
office	string	An account address: office.
zip	string	An account address: a zip-code.
phone	string	A phone number of the account: + < country code > < city code or network code > < phone number > 00 < country code > < city code or network code > < phone number >
email	string	A contact email of the account.
status	string	A current account status: active - an account is available for any possible operation (for more information see 2017-05-19_17-06-44_Comparison of Account's statuses in the ActivePlatform. Operator Control Panel); administrative hold - an account was blocked by manager (see Moving an account to the administrative hold in the ActivePlatform. Operator Control Panel); credit hold - an account was blocked automatically due to the debt on the account balance (see 2017-05-19_17-04-45_Credit Hold of the Account in the ActivePlatform. Operator Control Panel). 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 in the ActivePlatform. Operator Control Panel). deleted - an account was deleted by manger (see Deleting an account in the ActivePlatform. Operator Control Panel).
balance	float	A current value of the account balance (see Viewing the List of Charges in the ActivePlatform. Operator Control Panel).
credit_limit	float	A maximum amount of the credit that a customer can use for ordering services without topping up (the credit limit can be set manually or by default (see Account classes in the ActivePlatform. Operator Control Panel)).
account_type_id	integer	An ID of the account type.
account_type	string	A name of the account type.
manager_id	integer	A manager ID who is linked with the account.
owner_id	integer	An ID of the existed user who is granted the owner access rights in the Customer Control Panel.
tech_user_id	integer	An ID of the user, which is responsible for the technical matters.
bill_user_id	integer	An ID of the user, which is responsible for the financial matters.
custom_attributes	array	A list of additional attributes (see Managing attributes in the ActivePlatform. Operator Control Panel): name - a name of the attribute; value - a value of the attribute.
created_at	date	A date and time of the account's creation.
updated_at	date	A date and time, when the account information was updated.

Request example

GET http://billing.activeplatform.com:80/api/vendor/v1/accounts/2000532.json?api_token=654321

Response example

 {
  "id": 2000532,
  "name": "ActivePlatform",
  "account_class_id": 1,
  "account_class": "Default",
  "primary_name": "ActivePlatform",
  "first_name": "John",
  "middle_name": "",
  "last_name": "Doe",
  "country": "BY",
  "region": "Minsk",
  "city": "Minsk",
  "street": "Lenina",
  "building": "1",
  "office": "",
  "zip": "220007",
  "phone": "+375290001122",
  "email": "admin@activeplatform.com",
  "status": "active",
  "balance": "4963.14",
  "credit_limit": "2147483647.0",
  "account_type_id": 2,
  "account_type": "Business",
  "manager_id": null,
  "owner_id": 2001840,
  "tech_user_id": 2001840,
  "bill_user_id": 2001840,
  "custom_attributes": {
    "passport_number": "111111",
    "passport_issued_by": "111111",
    "personal_number": "220007",
    "passport_date_of_issue": "01.07.2016",
    "birth_date": "01.07.2016",
    "unp": "12341234",
    "kpp": "14234132",
    "registration_date": "06.01.2001",
    "registration_number": "13412341",
    "bank_account": "13241234",
    "bank_name": "Bank",
    "contact_charter": "41234123",
    "inn": "253124321",
    "okpo": "23142341",
    "resolution_number": "12.07.2016",
    "bankcode": "0001",
    "registration_authority": "12341234",
    "contact_position": "21342341"
  },
  "created_at": "2016-07-20T13:25:29.400+03:00",
  "updated_at": "2016-10-01T01:12:21.017+03:00"
}