get https://{subdomain}.kommo.com/api/v4/account
The method allows getting the account information.
Limitations
The method is available for all account users.
“with” Parameters
| Parameter | Description |
|---|---|
| amojo_id | Adds the account ID in the online chat service to the response |
| amojo_rights | Adds in response information about the availability of the functionality for creating group and using direct chats by users |
| users_groups | Adds information about the available groups of account users to the response |
| task_types | Adds to the response information about the available types of tasks in the account |
| version | Adds information about the current version of Kommo to the response |
| entity_names | Adds entity names to the response with their translations and number forms |
| datetime_settings | Adds to the response information about the current settings of the account’s date and time formats |
| drive_url | Adds the file service address for the requested account |
Data type header when the request is successful
Content-Type: application/hal+json
Data type header in case of an error
Content-Type: application/problem+json
Response parameters
| Parameter | Data type | Is 'with' required? | Description |
|---|---|---|---|
| id | int | ❌ | Account ID |
| name | string | ❌ | Account name |
| subdomain | string | ❌ | Account subdomain |
| current_user_id | int | ❌ | Current user ID |
| country | string | ❌ | Country specified in the account settings |
| currency | string | ❌ | Currency specified in the account settings |
| currency_symbol | string | ❌ | Currency symbol |
| is_unsorted_on | bool | ❌ | Is the Incoming leads functionality is enabled? |
| is_loss_reason_enabled | bool | ❌ | Is the Reason for close-lost leads functionality enabled? |
| is_helpbot_enabled | bool | ❌ | Is the AI power-up functionality enabled? (available only on the Enterprise subscription plan) |
| is_technical_account | bool | ❌ | Is the account technical? |
| contact_name_display_order | int | ❌ | Defines the order of the contact’s name (1 – First Name, Last Name; 2 – Last Name, First Name). |
| amojo_id | string | ✅ | Unique account identifier in the online chat service amojo. |
| version | int | ✅ | Current Kommo version |
| _embedded[amojo_rights] | obj | ✅ | Chats settings object |
| _embedded[can_direct] | obj | ✅ | Defines whether internal chats are available. |
| _embedded[can_create_groups] | obj | ✅ | Defines whether group chats are available. |
| _embedded[users_groups] | array | ✅ | Array of the Kommo user groups objects |
| _embedded[0][id] | int | ✅ | User group ID |
| _embedded[0][name] | string | ✅ | User group name |
| _embedded[task_types] | array | ✅ | Task types on the account |
| _embedded[0][id] | int | ✅ | Task type ID |
| _embedded[0][name] | string | ✅ | Task type name |
| _embedded[0][color] | string | ✅ | Task type color |
| _embedded[0][icon_id] | int | ✅ | Task type icon ID |
| _embedded[0][code] | string | ✅ | Task type code |
| _embedded[datetime_settings] | obj | ✅ | Date and time settings and format in the account |
| _embedded[entity_names] | obj | ✅ | Entities names settings |