> For a complete documentation index, fetch https://docs.voximplant.ai/llms.txt

# VoximplantAPI

## Classes

* [Client](/api-reference/voxengine/voximplant-api/client)

## Types

### A2PGetSmsHistoryRequest

*optional*

Maximum number of resulting rows fetched. Must be not bigger than 1000. If left blank, then the default value of 1000 is used

*optional*

The delivery status ID: QUEUED - 1, DISPATCHED - 2, ABORTED - 3, REJECTED - 4, DELIVERED - 5, FAILED - 6, EXPIRED - 7, UNKNOWN - 8

*optional*

The destination phone number

*optional*

Date from which the search is to start. Format is 'yyyy-MM-dd HH:mm:ss', time zone is UTC

*optional*

The first **N** records are skipped in the output

*optional*

The output format. The following values available: **json**, **csv**, **xls**. The default value is **json**

*optional*

The source phone number

*optional*

Date from which the search is to end. Format is 'yyyy-MM-dd HH:mm:ss', time zone is UTC

### A2PGetSmsHistoryResponse

*optional*

Total number of messages matching the query parameters

### A2PSendSmsRequest

The destination phone numbers separated by semicolons (;). The maximum number of these phone numbers is 100

The SenderID for outgoing SMS. Please contact support for installing a SenderID

*optional*

Whether to store outgoing message texts. Default value is false

The message text, up to 1600 characters. We split long messages greater than 160 GSM-7 characters or 70 UTF-16 characters into multiple segments. Each segment is charged as one message

### A2PSendSmsResponse

*optional*

The number of fragments the message is divided into

### A2PSmsHistory

The message cost

Delivery status: QUEUED, DISPATCHED, ABORTED, REJECTED, DELIVERED, FAILED, EXPIRED, UNKNOWN

SMS destination number

*optional*

Error message (if any)

Number of fragments the initial message is divided into

Message ID

Date of message processing. The format is yyyy-MM-dd HH:mm:ss

SMS source number

The message status. The possible values are: 1 — Success, 2 — Error, 3 — Waiting

*optional*

Stored message text

The transaction ID for this message

### AccountInfo

*optional*

Whether to activate one-way SMS

*optional*

The allowed access entries (the API function names)

*optional*

The custom data

The account's email

*optional*

The first name

The account's ID

*optional*

The last name

The account's name

*optional*

Whether Voximplant notifications are required

Whether the account is active

*optional*

The account API key. Use password or api\_key authentication to show the api\_key

*optional*

The account's money

*optional*

The office address

*optional*

The billing address country code (2 symbols, ISO 3166-1 alpha-2). Examples: US, RU, GB

*optional*

The company or businessman name

*optional*

The office phone number

*optional*

The office state (US) or province (Canada), up to 100 characters. Examples: California, Illinois, British Columbia

*optional*

The office ZIP

*optional*

The payments limits applicable to each payment method

*optional*

If salt string is specified, each HTTP request made by the Voximplant cloud toward the **callback\_url** has a **salt** field set to MD5 hash of account information and salt. That hash can be used be a developer to ensure that HTTP request is made by the Voximplant cloud

*optional*

If URL is specified, Voximplant cloud makes HTTP POST requests to it when something happens. For a full list of reasons see the **type** field of the `AccountCallback` structure. The HTTP request has a JSON-encoded body that conforms to the `AccountCallbacks` structure

The UTC account created time in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The account's credit limit

*optional*

The currency code (USD, RUR, EUR, ...)

*optional*

Whether account is blocked by Voximplant admins

*optional*

The notification language code (2 symbols, ISO639-1). Examples: en, ru

*optional*

The account location (timezone). Examples: America/Los\_Angeles, Etc/GMT-8, Etc/GMT+10

*optional*

The min balance value to notify by email or SMS

*optional*

Whether Voximplant news notifications are required

*optional*

Whether to send an email when a JS error occurs

*optional*

Whether Bank card payments are allowed

*optional*

Whether Bank invoices are allowed

*optional*

Whether Robokassa payments are allowed

*optional*

Whether Voximplant plan changing notifications are required

*optional*

Whether the admin user permissions are granted

### AccountInvoice

Info on all money spent in the invoice

Date when the invoice is created in the following format: YYYY-MM-DD

Invoice id

Unique invoice number

Invoice period

Detailed info on each spending

Invoice status

### AccountsInterface

Gets the account's info such as account\_id, account\_name, account\_email etc.

Gets the exchange rate on selected date (per USD).

### ACDAfterServiceOperatorState

*optional*

The operator [status string](/docs/references/websdk/voximplant/operatoracdstatuses)

The display user name of the operator

The user ID of the operator

The user name of the operator

### ACDLock

The UTC lock created time in 24-h format: YYYY-MM-DD HH:mm:ss

The ACD lock ID

### ACDLockedOperatorState

*optional*

The ACD operator calls

*optional*

The operator locks

*optional*

The operator [status string](/docs/references/websdk/voximplant/operatoracdstatuses). 'BANNED' string indicates temporarily [banned operators](/docs/guides/smartqueue/acdv1). The following values are possible: READY, BANNED

*optional*

The UTC time when the operator becomes unavailable in 24-h format: YYYY-MM-DD HH:mm:ss

The display user name of the operator

The user ID of the operator

The user name of the operator

### ACDOperatorCall

The ACD queue ID

The ACD queue name

The internal ACD session history ID

The ACD session history ID of the request

The begin time of the request in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The client callerid

*optional*

The submission time of the request in 24-h format: YYYY-MM-DD HH:mm:ss

### ACDQueueOperatorInfo

The ACD queue ID

The ACD queue name

Whether the user is bound to the ACD queue in manual mode if false

### ACDQueueState

The ACD queue ID

Number of operators with the 'AFTER SERVICE' state

List of operators with the 'AFTER\_SERVICE' state. This state is set right after a call is ended to indicate a call postprocessing

List of operators with the 'READY' state that cannot accept a call from this queue. Operator cannot accept a call if they are temporarily banned, or they are servicing a call right now

Number of locked operators

List of operators with the 'READY' state that can accept a call from this queue

Number of ready operators

List of calls enqueued into this queue that are being serviced right now by operators

List of calls enqueued into this queue that are not yet serviced by operators

### ACDReadyOperatorState

The idle duration in seconds. The minimum of the duration after the last hangup and the duration after the operator status changing to READY

The display user name of the operator

The user ID of the operator

The user name of the operator

### ACDServicingCallState

The ACD session history ID of the request

The begin time of the request in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The client callerid

The request priority

The display user name of the operator

The user ID of the operator

The user name of the operator

The waiting time before servicing in seconds

### ACDState

The queues' states

### ACDWaitingCallState

The ACD session history ID of the request

The begin time of the request in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The client callerid

The predicted minutes left to start servicing

The request priority

The display user name of the operator

*optional*

The user ID of the operator to try to service the request

The user name of the operator

The waiting time in seconds

### ActivateOutboundTestPhoneNumberRequest

The verification code, see the `VerifyOutboundTestPhoneNumber` function

### ActivateOutboundTestPhoneNumberResponse

*optional*

Returns 1 if the request has been completed successfully

### AddAdminRoleRequest

*optional*

Whether the admin role is enabled. If false the allowed and denied entries have no affect

The admin role name. The length must be less than 50

*optional*

The list of allowed access entries separated by semicolons (;) (the API function names)

*optional*

The list of denied access entries separated by semicolons (;) (the API function names)

*optional*

The admin role ID list separated by semicolons (;). Use the 'all' value to select all admin roles. The list specifies the roles from which the new role automatically copies all permissions (allowed\_entries and denied\_entries)

*optional*

The admin role name that can be used instead of **like\_admin\_role\_id**. The name specifies a role from which the new role automatically copies all permissions (allowed\_entries and denied\_entries)

### AddAdminRoleResponse

The new admin role ID

*optional*

Returns 1 if the request has been completed successfully

### AddAdminUserRequest

*optional*

The role(s) ID created via [Managing Admin Roles](/docs/references/httpapi/adminroles) methods. The attaching admin role ID list separated by semicolons (;). Use the 'all' value to select all admin roles

*optional*

The role(s) name(s) created via [Managing Admin Roles](/docs/references/httpapi/adminroles) methods. The attaching admin role name that can be used instead of **admin\_role\_id**

*optional*

Whether the admin user is active

The admin user display name. The length must be less than 256

The admin user name. The length must be less than 50

The admin user password. The length must be at least 6 symbols

### AddAdminUserResponse

The admin user API key

The new admin user ID

*optional*

Returns 1 if the request has been completed successfully

### AddApplicationRequest

Short application name in the \[a-z]\[a-z0-9-]\{1,64} format

*optional*

Whether to enable secure storage for all logs and records of the application

### AddApplicationResponse

The application ID

The full application name

*optional*

Returns 1 if the request has been completed successfully

Whether a secure storage for logs and records is enabled or not

### AddAuthorizedAccountIPRequest

*optional*

Whether to remove the IP from the blacklist

The authorized IP4 or network

*optional*

The IP address description

### AddAuthorizedAccountIPResponse

*optional*

Returns 1 if the request has been completed successfully

### AddOutboundTestPhoneNumberRequest

The personal phone number in the E.164 format

### AddOutboundTestPhoneNumberResponse

*optional*

Returns 1 if the request has been completed successfully

### AddPstnBlackListItemRequest

The phone number in format e164 or regex pattern

### AddPstnBlackListItemResponse

*optional*

The PSTN black list item ID

Returns 1 if the request has been completed successfully

### AddQueueRequest

The queue name. The length must be less than 100

*optional*

The integer queue priority. The highest priority is 0

The application ID

The application name that can be used instead of **application\_id**

*optional*

Whether to enable the auto binding of operators to a queue by skills comparing

*optional*

The average service time in seconds. Specify the parameter to correct or initialize the waiting time prediction

*optional*

The max queue size

*optional*

The max predicted waiting time in minutes. The client is rejected if the predicted waiting time is greater than the max predicted waiting time

*optional*

The value in the range of \[0.5 ... 1.0]. The value 1.0 means the service probability 100% in challenge with a lower priority queue

### AddQueueResponse

The ACD queue ID

*optional*

Returns 1 if the request has been completed successfully

### AddSecretRequest

Application ID to add the secret to

Application name. Can be used instead of **application\_id**

*optional*

Optional. Secret description. When processing, the length is truncated to the first 200 characters

Secret name. The name must start with a Latin letter and can contain up to 64 characters, including Latin letters, digits and underscores

Secret value. Maximum length is 8192 characters

### AddSecretResponse

*optional*

Result with the added secret ID

### AddSecretResult

Added secret ID

### AddSipWhiteListItemRequest

*optional*

The network address description

The network address in format A.B.C.D/L or A.B.C.D/a.b.c.d (example 192.168.1.5/16)

### AddSipWhiteListItemResponse

*optional*

Returns 1 if the request has been completed successfully

The SIP white list item ID

### AddSkillRequest

The ACD operator skill name. The length must be less than 512

### AddSkillResponse

*optional*

Returns 1 if the request has been completed successfully

The skill ID

### AddUserRequest

The application ID which a new user is to be bound to. Can be used instead of the **application\_name** parameter

The application name which a new user is to be bound to. Can be used instead of the **application\_id** parameter

*optional*

*optional*

Whether the user uses the parent account's money, 'false' if the user has a separate balance

*optional*

Whether the user is active. Inactive users cannot log in to applications

*optional*

Any string

The user display name. The length must be less than 256

The user name in format \[a-z0-9]\[a-z0-9\_-]\{2,49}

The user password. Must be at least 8 characters long and contain at least one uppercase and lowercase letter, one number, and one special character

### AddUserResponse

*optional*

Returns 1 if the request has been completed successfully

The new user ID

### AdminRole

Whether to ignore the allowed and denied entries

The admin role ID

The admin role name

*optional*

The allowed access entries (the API function names)

*optional*

The denied access entries (the API function names)

The admin role editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

Whether it is a system role

### AdminRolesInterface

Adds a new admin role.

Deletes the specified admin role.

Gets the admin roles.

Gets the all available admin role entries.

Edits the specified admin role.

### AdminUser

*optional*

The allowed access entries (the API function names)

*optional*

The attached admin roles

Whether login is allowed

The admin user display name

The admin user ID

The admin user name

The admin user editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

### AdminUsersInterface

Adds a new admin user into the specified parent or child account.

Attaches the admin role(s) to the already existing admin(s).

Deletes the specified admin user.

Gets the admin users of the specified account. Note that both account types - parent and child - can have its own admins.

Edits the specified admin user.

### APIError

The error code

The error description

### AppendToCallListRequest

*optional*

Separator values. The default value is ';'

*optional*

Encoding file. The default value is UTF-8

*optional*

Escape character for parsing csv

Send as the request body or multiform

Call list ID

### AppendToCallListResponse

Batch UUID

Number of stored records

*optional*

List ID

Whether the request completed successfully

### ApplicationInfo

The application ID

The full application name

The application editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

Whether a secure storage for logs and records is enabled

### ApplicationsInterface

Adds a new account's application.

Deletes the account's application.

Gets the account's applications.

Edits the account's application.

### AttachAdminRoleRequest

The role(s) ID created via [Managing Admin Roles](/docs/references/httpapi/adminroles) methods. The attached admin role ID list separated by semicolons (;). Use the 'all' value to select alladmin roles

The role(s) name(s) created via [Managing Admin Roles](/docs/references/httpapi/adminroles) methods. The admin role name to attach, can be used instead of **admin\_role\_id**

*optional*

The merge mode. The following values are possible: add, del, set

The admin user ID list separated by semicolons (;). Use the 'all' value to select all admin users

The admin user name to bind, can be used instead of **required\_admin\_user\_id**

### AttachAdminRoleResponse

*optional*

Returns 1 if the request has been completed successfully

### AttachedPhoneInfo

*optional*

Phone number activation status

*optional*

ID of the bound application

*optional*

Name of the bound application

Whether to charge automatically

Whether a not verified account can use the phone

Whether the subscription is cancelled

The phone category name (MOBILE, GEOGRAPHIC, TOLLFREE, MOSCOW495)

Whether the subscription is frozen

Whether calls to emergency numbers are enabled

Whether you need to make a request to enable calls to emergency numbers

*optional*

Full application name, e.g. myapp.myaccount.n1.voximplant.com

*optional*

If set, the callback of an incoming SMS is sent to this url, otherwise, it is sent to the general account URL

Whether SMS sending and receiving is enabled for this phone number via the `ControlSms` Management API

Whether SMS is supported for this phone number. SMS needs to be explicitly enabled via the `ControlSms` Management API before sending or receiving SMS. If SMS is supported and enabled, SMS can be sent from this phone number via the `SendSmsMessage` Management API and received via the `InboundSmsCallback` property of the HTTP callback. See [this article](/docs/guides/managementapi/callbacks) for HTTP callback details

UTC date of an event associated with the number in 24-h format: YYYY-MM-DD HH:mm:ss

The phone country code (2 symbols)

The phone ID

The next renewal date in the following format: YYYY-MM-DD

The phone number

The phone monthly charge in the account's currency

The purchase date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Phone region name

*optional*

Whether the verification is required for the account

*optional*

ID of the bound rule

*optional*

Name of the bound rule

Phone number subscription ID

*optional*

Unverified phone hold until the date in the following format: YYYY-MM-DD (if the account verification is required). The number is detached on that day automatically!

*optional*

The account verification status. The following values are possible: REQUIRED, IN\_PROGRESS, VERIFIED

### AuthorizedAccountIP

Whether the IP is allowed (true - whitelist, false - blacklist)

The authorized IP4 or network

The item creating UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

### AuthorizedIPsInterface

Adds a new authorized IP4 or network to the white/black list.

Tests whether the IP4 is banned or allowed.

Removes the authorized IP4 or network from the white/black list.

Gets the authorized IP4 or network.

### BankCardBillingLimitInfo

The currency

The minimum amount

### BillingLimitInfo

The currency

The minimum amount

### BillingLimits

*optional*

The bank card limits

*optional*

The invoice limits

*optional*

The Robokassa limits

### BindSipRegistrationRequest

*optional*

The application ID which the SIP registration is to be bound to. Can be used instead of the **application\_name** parameter

*optional*

The application name which the SIP registration is to be bound to. Can be used instead of the **application\_id** parameter

*optional*

Whether to bind or unbind (set true or false respectively)

*optional*

The rule ID which the SIP registration is to be bound to. Can be used instead of the **rule\_name** parameter

*optional*

The rule name which the SIP registration is to be bound to. Can be used instead of the **rule\_id** parameter

*optional*

The registration ID

*optional*

The user ID which the SIP registration is to be bound to. Can be used instead of the **user\_name** parameter

*optional*

The user name which the SIP registration is to be bound to. Can be used instead of the **user\_id** parameter

### BindSipRegistrationResponse

*optional*

Returns 1 if the request has been completed successfully

### BindSkillRequest

The ACD queue ID list separated by semicolons (;). Use the 'all' value to select all ACD queues

The ACD queue name that can be used instead of **acd\_queue\_id**. The ACD queue name list separated by semicolons (;)

*optional*

The application ID. It is required if the **user\_name** is specified

*optional*

The application name that can be used instead of **application\_id**

*optional*

Whether to bind or unbind (set true or false respectively)

The skill ID list separated by semicolons (;). Use the 'all' value to select all skills

The skill name list separated by semicolons (;). Can be used instead of **skill\_id**

The user ID list separated by semicolons (;). Use the 'all' value to select all users

The user name list separated by semicolons (;). **user\_name** can be used instead of **user\_id**

### BindSkillResponse

*optional*

Returns 1 if the request has been completed successfully

### BindUserToQueueRequest

The ACD queue ID list separated by semicolons (;). Use the 'all' value to specify all queues bound to the application

The queue name that can be used instead of **acd\_queue\_id**. The queue name list separated by semicolons (;)

The application ID

The application name that can be used instead of **application\_id**

Whether to bind or unbind users

The user ID list separated by semicolons (;). Use the 'all' value to specify all users bound to the application

The user name list separated by semicolons (;). **user\_name** can be used instead of **user\_id**

### BindUserToQueueResponse

*optional*

Returns 1 if the request has been completed successfully

### CallerIDInfo

Whether active

The callerID id

The callerID number

*optional*

The code entering attempts left for the unverified callerID

*optional*

The verification call attempts left for the unverified callerID

*optional*

The verification ending date in the following format: YYYY-MM-DD (for the verified callerID)

### CallerIDsInterface

Deletes the CallerID. Note: you cannot delete a CID permanently (the antispam defence).

Gets the account callerIDs.

### CallInfo

Call's history ID

*optional*

Call's cost

*optional*

Custom data passed to the JS session

*optional*

Call forwarding number

*optional*

Call duration in seconds

*optional*

End reason code and description

Whether the call is incoming

Local number on the platform side

Media server's IP address

*optional*

Record URL

Remote number on the client side

Type of the remote number, e.g., a PSTN, mobile, user or sip address

Call start time in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

Whether the call is successful

Transaction ID

### CallList

*optional*

The completion date in 24-h format: YYYY-MM-DD HH:mm:ss

The date of submitted the list in 24-h format: YYYY-MM-DD HH:mm:ss

The interval between attempts in seconds

The list ID

The list name

The maximum number of simultaneous tasks

The number of task attempts run, which failed to call

The priority of the call list

The rule id

The status name. The possible values are **In progress**, **Completed**, **Canceled**

Whether the first or repeated calls have priority.

### CallListsInterface

Appends a new task to the existing call list.
This method accepts CSV files with custom delimiters, such a commas (,), semicolons (;) and other. To specify a delimiter, pass it to the **delimiter** parameter.

Cancels all tasks in the call list with the specified batch UUID.

Cancels the specified tasks in the call list by their IDs or UUIDs. The maximum number of tasks to cancel is 1000.

Adds a new CSV file for call list processing and starts the specified rule immediately. To send a file, use the request body. To set the call time constraints, use the following options in a CSV file: **\_\_start\_execution\_time** – when the call list processing starts every day, UTC+0 24-h format: HH:mm:s&#x73;**\_\_end\_execution\_time** – when the call list processing stops every day,  UTC+0 24-h format: HH:mm:s&#x73;**\_\_start\_at** – when the call list processing starts, UNIX timestamp. If not specified, the processing starts immediately after a method cal&#x6C;**\_\_task\_uuid** – call list UUID. A string up to 40 characters, can contain latin letters, digits, hyphens (-) and colons (:). Unique within the call list
This method accepts CSV files with custom delimiters, such a commas (,), semicolons (;) and other. To specify a delimiter, pass it to the **delimiter** parameter.
**IMPORTANT:** the account's balance should be equal or greater than 1 USD. If the balance is lower than 1 USD, the call list processing does not start, or it stops immediately if it is active.

Deletes an existing call list by its ID.

Edits the specified call list by its ID.

Edits priorities of existing tasks in the specified call list.

Get all call lists for the specified user.

### CallSessionInfo

Account ID that initiates the JS session

Application ID that initiates the JS session

Application name

Call's audio quality. The possible values are: Standard | HD | Ultra HD.

*optional*

Calls within the JS session, including durations, cost, phone numbers and other information

Unique JS session identifier

*optional*

Custom data

*optional*

Entire JS session duration in seconds. The session can contain multiple calls

*optional*

Finish reason. Possible values are **Normal termination**, **Insufficient funds**, **Internal error (billing timeout)**, **Terminated administratively**, **JS session error**, **Timeout**

Initiator's IP address

Link to the session log. The log retention policy is 1 month, after that time this field clears. If you have issues accessing the log file, check if the application has "Secure storage of applications and logs" feature enabled. In this case, you need to `authorize`(/docs/guides/managementapi/secureobjects).

Media server IP address

*optional*

Used resources

*optional*

Bound records

Routing rule name

Start date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

User ID that initiates the JS session

### CancelCallListBatchRequest

Batch UUIDs of the tasks to cancel, separated by semicolon (;)

Call list ID

### CancelCallListBatchResponse

*optional*

Whether the request completed successfully

### CancelCallListTaskRequest

Account's ID

Call list's ID

*optional*

Task IDs separated by a semicolon. Specify either `tasks_ids` or `tasks_uuids`. The method returns an error if none of the parameters is specified

*optional*

Task UUIDs separated by a semicolon. Specify either `tasks_ids` or `tasks_uuids`. The method returns an error if none of the parameters is specified

### CancelCallListTaskResponse

*optional*

Reason for the error

Result of the operation

Task's ID

Task's UUID

### CheckAuthorizedAccountIPRequest

The IP4 to test

### CheckAuthorizedAccountIPResponse

*optional*

The matched authorized IP or network (if found)

*optional*

Whether the IP is allowed

### ControlSmsRequest

The SMS control command. The following values are possible: enable, disable

The phone number

### ControlSmsResponse

*optional*

### CreateCallListRequest

*optional*

Separator values. The default value is ';'

*optional*

Encoding file. The default value is UTF-8

*optional*

Escape character for parsing csv

Send as the "body" part of the HTTP request or as multiform. The sending "file\_content" via URL is at its own risk because the network devices tend to drop HTTP requests with large headers

*optional*

Interval between call attempts in seconds. The default value is 0

Number of simultaneously processed tasks

File name, up to 255 characters and cannot contain the '/' and '' symbols

Number of attempts. Minimum is **1**, maximum is **5**

Call list priority. The value is in the range of \[0 ... 2^31] where zero is the highest priority

*optional*

IP from the geolocation of the call list subscribers. It allows selecting the nearest server for serving subscribers

Rule ID. It is specified in the `Applications`(//manage.voximplant.com/applications) section of the Control Panel

*optional*

Location of the server where the scenario needs to be executed. Has higher priority than `reference_ip`. Request `getServerLocations`([https://api.voximplant.com/getServerLocations](https://api.voximplant.com/getServerLocations)) for possible values

*optional*

Optional. Whether to prioritize first calling attempts or repeated ones. The possible values are: first\_attempts, repeated\_attempts. The default values is first\_attempts.

### CreateCallListResponse

Batch UUID

Number of stored records

*optional*

List ID

Whether the request completed successfully

### DelAdminRoleRequest

The admin role ID list separated by semicolons (;). Use the 'all' value to select all admin roles

The admin role name to delete, can be used instead of **admin\_role\_id**

### DelAdminRoleResponse

*optional*

Returns 1 if the request has been completed successfully

### DelAdminUserRequest

The admin user ID list separated by semicolons (;). Use the 'all' value to select all admin users

The admin user name to delete, can be used instead of **required\_admin\_user\_id**

### DelAdminUserResponse

*optional*

Returns 1 if the request has been completed successfully

### DelApplicationRequest

The application ID list separated by semicolons (;). Use the 'all' value to select all applications

The application name list separated by semicolons (;). Can be used instead of **application\_id**

### DelApplicationResponse

*optional*

Returns 1 if the request has been completed successfully

### DelAuthorizedAccountIPRequest

*optional*

Whether to remove the network from the white list. Set false to remove the network from the black list. Omit the parameter to remove the network from all lists

The authorized IP4 or network to remove. Set to 'all' to remove all items

Specify the parameter to remove the networks that contains the particular IP4. Can be used instead of **authorized\_ip**

### DelAuthorizedAccountIPResponse

*optional*

The removed network count

### DelCallerIDRequest

ID of the callerID object

The callerID number that can be used instead of **callerid\_id**

### DelCallerIDResponse

*optional*

Returns 1 if the request has been completed successfully

### DeleteCallListRequest

Account's ID

### DeleteCallListResponse

*optional*

Text description

Result

### DelKeyValueItemRequest

The application ID

*optional*

The application name

Key, up to 200 characters

### DelKeyValueItemResponse

*optional*

### DelOutboundTestPhoneNumberRequest

### DelOutboundTestPhoneNumberResponse

*optional*

Returns 1 if the request has been completed successfully

### DelPstnBlackListItemRequest

The PSTN black list item ID

### DelPstnBlackListItemResponse

*optional*

Returns 1 if the request has been completed successfully

### DelQueueRequest

The ACD queue ID list separated by semicolons (;)

The ACD queue name that can be used instead of **acd\_queue\_id**. The ACD queue name list separated by semicolons (;)

### DelQueueResponse

*optional*

Returns 1 if the request has been completed successfully

### DelSecretRequest

Application ID

Application name. Can be used instead of **application\_id**

IDs to delete. A list separated by semicolons (;). Use the 'all' value to delete all secrets

Secret names to delete. List separated by semicolons (;)

### DelSecretResponse

*optional*

Returns 1 if the secret has been deleted successfully

### DelSipWhiteListItemRequest

The SIP white list item ID to delete

### DelSipWhiteListItemResponse

*optional*

Returns 1 if the request has been completed successfully

### DelSkillRequest

The skill ID

The skill name that can be used instead of **skill\_id**

### DelSkillResponse

*optional*

Returns 1 if the request has been completed successfully

### DelUserRequest

*optional*

Delete the specified users bound to the application ID. It is required if the **user\_name** is specified

*optional*

Delete the specified users bound to the application name. Can be used instead of the **application\_id** parameter

The user ID list separated by semicolons (;). Use the 'all' value to select all users

The user name list separated by semicolons (;) that can be used instead of **user\_id**

### DelUserResponse

*optional*

Returns 1 if the request has been completed successfully

### DialogflowCredentialsInterface

Edits a Dialogflow key.

### DownloadInvoiceRequest

Invoice ID

### DownloadInvoiceResponse

*optional*

The method returns a raw data, there is no 'file\_content' parameter in fact

### EditCallListRequest

*optional*

Minimum interval between call attempts. Cannot be a negative value

*optional*

IP address in the `Inet4Address` format

Call list ID. If the ID is non existing, the 251 error returns

*optional*

Maximum simultaneous call attempts for this call list. Cannot be less than 1

*optional*

Call list name. Cannot be bigger than 255 characters, cannot contain slash symbol

*optional*

Maximum call attempt number. Cannot be less than 1

*optional*

Call list's priority among other call list. The lower the value, the higher is the call list's priority

*optional*

Location of the server processing the call list. If the ID is non existing, the 496 error returns: The 'server\_location' parameter is invalid.

*optional*

Time when the call list should start in the `yyyy-MM-dd HH:mm:ss` format

*optional*

Optional. Whether to prioritize first calling attempts or repeated ones. The possible values are: first\_attempts, repeated\_attempts. The default values is first\_attempts

### EditCallListResponse

*optional*

Whether the request completed successfully

### EditCallListTasksPriorityRequest

Call list ID. If the ID does not exist, the 251 error returns.

JSON-encoded array of task objects. Each object should contain either 'task\_id' (number) or 'task\_uuid' (string), and 'task\_priority' (number).

### EditCallListTasksPriorityResponse

*optional*

JSON-encoded array of each task update.

### ExchangeRates

*optional*

The EUR exchange rate

*optional*

The KZT exchange rate

*optional*

The RUR exchange rate

*optional*

The USD exchange rate. It is always equal to 1

### FailedSms

The SMS destination number

The error code

The error description

### GetAccountInfoRequest

*optional*

Whether to get the account's live balance

### GetAccountInfoResponse

The preferred address for the Management API requests

*optional*

Account's info as the `AccountInfoType` object instance

### GetAccountInvoicesRequest

*optional*

Number of invoices to show per page. Default value is 20

*optional*

Number of invoices to skip (e.g. if you set count = 20 and offset = 0 the first time, the next time, offset has to be equal to 20 to skip the items shown earlier). Default value is 0

*optional*

### GetAccountInvoicesResponse

Number of returned invoices matching the query parameters

*optional*

Array of the account invoices

Total number of invoices matching the query parameters

### GetACDStateRequest

*optional*

The ACD queue ID list separated by semicolons (;). Use the 'all' value to select all ACD queues

### GetACDStateResponse

*optional*

### GetAdminRolesRequest

*optional*

Whether the admin role is enabled to filter

*optional*

The admin role ID to filter

*optional*

The admin role name part to filter

*optional*

The max returning record count

*optional*

Not attached admin user ID list separated by semicolons (;). Use the 'all' value to select all admin users

*optional*

Set false to get roles with partial admin user list matching

*optional*

The attached admin user ID list separated by semicolons (;). Use the 'all' value to select all admin users

*optional*

The first **N** records are skipped in the output

*optional*

The admin user to show in the 'admin\_users' field output

*optional*

Whether to include the account roles

*optional*

Whether to get the permissions

*optional*

Whether to include the parent roles

*optional*

### GetAdminRolesResponse

The returned admin role count

*optional*

The total found admin role count

### GetAdminUsersRequest

*optional*

Whether the admin user is active to filter

*optional*

The admin user display name part to filter

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

The admin user ID to filter

*optional*

The admin user name part to filter

*optional*

Whether to get the admin user permissions

*optional*

Whether to get the attached admin roles

### GetAdminUsersResponse

The returned admin user count

*optional*

The total found admin user count

### GetApplicationsRequest

*optional*

The application ID to filter

*optional*

The application name part to filter

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

Whether to get bound rules info

*optional*

Whether to get bound rules and scenarios info

### GetApplicationsResponse

The returned application count

*optional*

The total found application count

### GetAuthorizedAccountIPsRequest

*optional*

Whether the IP is allowed

*optional*

The authorized IP4 or network to filter

*optional*

Specify the parameter to filter the networks that contains the particular IP4

*optional*

The max returning record count

*optional*

The IP address description

*optional*

The first **N** records are skipped in the output

### GetAuthorizedAccountIPsResponse

The returned network count

*optional*

The total found network count

### GetAvailableAdminRoleEntriesRequest

### GetAvailableAdminRoleEntriesResponse

*optional*

Array of the admin role entries

### GetBriefCallHistoryRequest

*optional*

To receive the call history for a specific application, pass the application ID to this parameter

*optional*

The application name, can be used instead of **application\_id**

*optional*

To filter the call history by the custom\_data passed to the call sessions, pass the custom data to this parameter

*optional*

To get the call history for the specific sessions, pass the session IDs to this parameter separated by a semicolon (;). You can find the session ID in the `AppEvents.Started`(/docs/references/voxengine/appevents#started) event's **sessionID** property in a scenario, or retrieve it from the **call\_session\_history\_id** value returned from the `StartScenarios`([https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios](https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios)) or `StartConference`([https://voximplant.com/docs/references/httpapi/scenarios#startconference](https://voximplant.com/docs/references/httpapi/scenarios#startconference)) methods

*optional*

Whether to get records in the descent order

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

To receive a call history for a specific local numbers, pass the number list separated by semicolons (;). A local number is a number on the platform side

The output format. The following values available: **csv**.

*optional*

To receive a call history for a specific remote numbers, pass the number list separated by semicolons (;). A remote number is a number on the client side

*optional*

To receive the call history for a specific routing rule, pass the rule name to this parameter. Applies only if you set application\_id or application\_name

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Whether to get a CSV file with the column names if the output=csv

### GetBriefCallHistoryResponse

*optional*

The history report ID

Returns 1 if the request has been completed successfully

### GetCallerIDsRequest

*optional*

Whether the account is active to filter

*optional*

ID of the callerID object to filter

*optional*

The phone number to filter

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

The following values are available: 'caller\_number' (ascent order), 'verified\_until' (ascent order)

### GetCallerIDsResponse

The returned record count

*optional*

The total found record count

### GetCallHistoryAsyncRequest

*optional*

To receive the call history for a specific application, pass the application ID to this parameter

*optional*

The application name, can be used instead of **application\_id**

*optional*

To filter the call history by the custom\_data passed to the call sessions, pass the custom data to this parameter

*optional*

To get the call history for the specific sessions, pass the session IDs to this parameter separated by a semicolon (;). You can find the session ID in the `AppEvents.Started`(/docs/references/voxengine/appevents#started) event's **sessionID** property in a scenario, or retrieve it from the **call\_session\_history\_id** value returned from the `StartScenarios`([https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios](https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios)) or `StartConference`([https://voximplant.com/docs/references/httpapi/scenarios#startconference](https://voximplant.com/docs/references/httpapi/scenarios#startconference)) methods

*optional*

The child account ID list separated by semicolons (;)

*optional*

Whether to get the children account calls only

*optional*

Whether to get records in the descent order

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

To receive a call history for a specific local numbers, pass the number list separated by semicolons (;). A local number is a number on the platform side

*optional*

The output format. The following values available: **csv**. The default value is **csv**

*optional*

To receive a call history for a specific remote numbers, pass the number list separated by semicolons (;). A remote number is a number on the client side

*optional*

To receive the call history for a specific routing rule, pass the rule name to this parameter. Applies only if you set application\_id or application\_name

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

To receive the call history for a specific users, pass the user ID list separated by semicolons (;). If it is specified, the output contains the calls from the listed users only

*optional*

Whether to receive a list of sessions with all calls within the sessions, including phone numbers, call cost and other information

*optional*

Whether to get a CSV file with the column names if the output=csv

*optional*

Whether to get other resources usage (see `ResourceUsageType`)

*optional*

Whether to get the calls' records

### GetCallHistoryAsyncResponse

*optional*

The history report ID

Returns 1 if the request has been completed successfully

### GetCallHistoryRequest

*optional*

To receive the call history for a specific application, pass the application ID to this parameter

*optional*

The application name, can be used instead of **application\_id**

*optional*

To filter the call history by the custom\_data passed to the call sessions, pass the custom data to this parameter

*optional*

To get the call history for the specific sessions, pass the session IDs to this parameter separated by a semicolon (;). The maximum number of records is 1000. You can find the session ID in the `AppEvents.Started`(/docs/references/voxengine/appevents#started) event's **sessionID** property in a scenario, or retrieve it from the **call\_session\_history\_id** value returned from the `StartScenarios`([https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios](https://voximplant.com/docs/references/httpapi/scenarios#reorderscenarios)) or `StartConference`([https://voximplant.com/docs/references/httpapi/scenarios#startconference](https://voximplant.com/docs/references/httpapi/scenarios#startconference)) methods

*optional*

The child account ID list separated by semicolons (;)

*optional*

Whether to get the children account calls only

*optional*

The number of returning records. The maximum value is 1000

*optional*

Whether to get records in the descent order

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

To receive a call history for a specific local numbers, pass the number list separated by semicolons (;). A local number is a number on the platform side

*optional*

The number of records to skip in the output. The maximum value of 10000

*optional*

To receive a call history for a specific remote numbers, pass the number list separated by semicolons (;). A remote number is a number on the client side. Ignored if the `remote_number_list` parameter is not empty

*optional*

A JS array of strings of specific remote phone numbers to sort the call history. Has higher priority than the `remote_number` parameter. If the array is empty, the `remote_number` parameter is used instead

*optional*

To receive the call history for a specific routing rule, pass the rule name to this parameter. Applies only if you set application\_id or application\_name

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

To receive the call history for a specific users, pass the user ID list separated by semicolons (;). If it is specified, the output contains the calls from the listed users only

*optional*

Whether to receive a list of sessions with all calls within the sessions, including phone numbers, call cost and other information

*optional*

Whether to get other resources usage (see `ResourceUsageType`)

*optional*

Whether to get the calls' records

*optional*

Whether to include the 'total\_count' and increase performance

### GetCallHistoryResponse

The returned call session count

*optional*

The CallSessionInfoType records

The used timezone

The total found call session count

### GetCallListsRequest

*optional*

The application ID to filter. Can be a list separated by semicolons (;). Use the 'all' value to select all applications

*optional*

The max returning record count

*optional*

The UTC 'from' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Whether to find only active call lists

*optional*

The list ID to filter. Can be a list separated by semicolons (;). Use the 'all' value to select all lists

*optional*

Find call lists by name

*optional*

The first **N** records are skipped in the output

*optional*

The UTC 'to' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The type of the call list. The possible values are AUTOMATIC and MANUAL

### GetCallListsResponse

Returned call list count

*optional*

Array of lists

Total found call list count

### GetCurrencyRateRequest

The currency code list separated by semicolons (;). Examples: RUR, KZT, EUR, USD

*optional*

The date, format: YYYY-MM-DD

### GetCurrencyRateResponse

*optional*

The exchange rates

### GetKeyValueItemRequest

The application ID

*optional*

The application name

Key, up to 200 characters

### GetKeyValueItemResponse

*optional*

The key-value item

### GetKeyValueItemsRequest

The application ID

*optional*

The application name

*optional*

Number of items to show per page with a maximum value of 50. Default value is 10

Namespace that keys should contain, up to 200 characters

*optional*

Number of items to skip (e.g. if you set count = 20 and offset = 0 the first time, the next time, offset has to be equal to 20 to skip the items shown earlier). Default value is 0

### GetKeyValueItemsResponse

*optional*

The key-value pairs

### GetKeyValueKeysRequest

The application ID

*optional*

The application name

*optional*

Number of items to show per page with a maximum value of 50. Default value is 10

*optional*

Namespace that keys should contain, up to 200 characters

*optional*

Number of items to skip (e.g. if you set count = 20 and offset = 0 the first time, the next time, offset has to be equal to 20 to skip the items shown earlier). Default value is 0

### GetKeyValueKeysResponse

*optional*

The key-value keys

### GetOutboundTestPhoneNumbersRequest

### GetOutboundTestPhoneNumbersResponse

*optional*

### GetPhoneNumbersAsyncRequest

*optional*

Whether to get a CSV file with the column names

### GetPhoneNumbersAsyncResponse

*optional*

The report ID (async mode)

### GetPhoneNumbersRequest

*optional*

Phone number activation statuses to filter, separated by semicolons (;).

The possible values are: ACTIVE, ACTIVATING, DEACTIVATED, PROVISIONING, AWAITING\_BUSINESS\_PHONE\_NUMBER\_CONFIGURATION, LEGAL\_OWNERSHIP\_LIMIT\_REACHED, GOSUSLUGI\_DECLINED, SELF\_BAN\_ENABLED

*optional*

Application ID

*optional*

Application name that can be used instead of **application\_id**

*optional*

Whether the auto\_charge flag is enabled

*optional*

Whether a not verified account can use the phone

*optional*

Whether the subscription is cancelled to filter

*optional*

Child account ID list separated by semicolons (;). Use the 'all' value to select all child accounts

*optional*

Whether to get the children phones only

*optional*

Maximum returning record count

*optional*

Country code list separated by semicolons (;)

*optional*

Whether the subscription is frozen to filter

*optional*

UTC 'from' date filter in the following format: YYYY-MM-DD

*optional*

UTC 'from' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Unverified phone hold until the date (from ...) in the following format: YYYY-MM-DD

*optional*

Whether the phone number bound to an application

*optional*

Whether the phone number is bound to some rule

*optional*

First **N** records are skipped in the output

*optional*

Following values are available: 'phone\_number' (ascent order), 'phone\_price' (ascent order), 'phone\_country\_code' (ascent order), 'deactivated' (deactivated first, active last), 'purchase\_date' (descent order), 'phone\_next\_renewal' (ascent order), 'verification\_status', 'unverified\_hold\_until' (ascent order), 'verification\_name'

*optional*

Phone category name. See the `GetPhoneNumberCategories` method

*optional*

Particular phone ID to filter

*optional*

Phone number list separated by semicolons (;) that can be used instead of **phone\_id**

*optional*

Region names list separated by semicolons (;)

*optional*

Phone number start to filter

*optional*

Rule ID list separated by semicolons (;)

*optional*

Rule names list separated by semicolons (;). Can be used only if **application\_id** or **application\_name** is specified

*optional*

Flag allows you to display only the numbers of the sandbox, real numbers, or all numbers. The following values are possible: 'all', 'true', 'false'

*optional*

*optional*

UTC 'to' date filter in the following format: YYYY-MM-DD

*optional*

UTC 'to' date filter in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Unverified phone hold until the date (... to) in the following format: YYYY-MM-DD

*optional*

Required account verification name to filter

*optional*

Account verification status list separated by semicolons (;). The following values are possible: REQUIRED, IN\_PROGRESS, VERIFIED

### GetPhoneNumbersResponse

Returned phone count

*optional*

Phone numbers info

Total found phone count

### GetPstnBlackListRequest

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

The PSTN black list item ID for filter

*optional*

The phone number in format e164 for filter

### GetPstnBlackListResponse

The returned phone numbers count

*optional*

The total found phone numbers count

### GetQueuesRequest

*optional*

The ACD queue ID to filter

*optional*

The ACD queue name part to filter

*optional*

The application ID to filter

*optional*

The max returning record count

*optional*

The excluded skill ID to filter

*optional*

The first **N** records are skipped in the output

*optional*

The skill to show in the 'skills' field output

*optional*

The skill ID to filter

*optional*

Whether to include the number of agents bound to the queue

*optional*

Whether to get the bound skills

### GetQueuesResponse

The returned queue count

*optional*

The total found queue count

### GetRecordStoragesRequest

*optional*

The record storage ID list separated by semicolons (;)

*optional*

The record storage name list separated by semicolons (;)

*optional*

### GetRecordStoragesResponse

*optional*

### GetRoleGroupsRequest

### GetRoleGroupsResponse

*optional*

### GetSecretsRequest

Application ID

Application name. Can be used instead of **application\_id**

*optional*

Maximum returning record number

*optional*

First **N** records to be skipped in the output

*optional*

Filter by the secret name part

### GetSecretsResponse

Returned secrets number

*optional*

Secrets list

Total found secrets number

### GetSecretValueRequest

Application ID

Application name. Can be used instead of **application\_id**

Secret ID

Secret name. Can be used instead of **secret\_id**

### GetSecretValueResponse

*optional*

The full secret info (with value)

### GetSecretValueResult

Secret creation timestamp

*optional*

Secret description

Secret modification timestamp

Secret ID

Secret name

Secret value

### GetSipRegistrationsRequest

*optional*

The application ID list separated by semicolons (;) to filter. Can be used instead of **application\_name**

*optional*

The application name list separated by semicolons (;) to filter. Can be used instead of **application\_id**

*optional*

The max returning record count

*optional*

Whether to show the frozen SIP registrations only

*optional*

Whether SIP registration is still in progress

*optional*

Whether SIP registration bound to an application

*optional*

Whether the SIP registration is persistent to filter

*optional*

The first **N** records are skipped in the output

*optional*

The list of proxy servers to use, divided by semicolon (;)

The rule ID list separated by semicolons (;) to filter. Can be used instead of **rule\_name**

The rule name list separated by semicolons (;) to filter. Can be used instead of **rule\_id**

*optional*

The SIP registration ID

*optional*

The SIP user name to filter

*optional*

The list of SIP response codes. The **code1:code2** means a range from **code1** to **code2** including; the **code1;code2** meanse either **code1** or **code2**. You can combine ranges, e.g., **code1;code2:code3**

*optional*

Whether to show the successful SIP registrations only

The user ID list separated by semicolons (;) to filter. Can be used instead of **user\_name**

### GetSipRegistrationsResponse

Count rows

*optional*

Active SIP registrations

### GetSipWhiteListRequest

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

The SIP white list item ID to filter

### GetSipWhiteListResponse

The returned networks count

*optional*

The total found networks count

### GetSkillsRequest

*optional*

The max returning record count

*optional*

The first **N** records are skipped in the output

*optional*

The skill ID to filter

*optional*

The skill name part to filter

### GetSkillsResponse

The returned skill count

*optional*

The total found skill count

### GetSmartQueueDayHistoryRequest

The application ID to search by

The application name to search by. Can be used instead of the **application\_id** parameter

*optional*

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 1 day

*optional*

Group the result by **agent** or *queue*. The **agent** grouping is allowed only for 1 queue and for the occupancy\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_banned\_time, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types. The **queue** grouping allowed for the calls\_blocked\_percentage, count\_blocked\_calls, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, occupancy\_rate, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types

*optional*

Interval format: YYYY-MM-DD HH:mm:ss. Default is 1 day

*optional*

Maximum waiting time. Required for the **service\_level** report type

The report type. Possible values are: calls\_blocked\_percentage, count\_blocked\_calls, im\_blocked\_chats\_percentage, im\_count\_blocked\_chats, im\_answered\_chats\_rate, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, im\_service\_level, occupancy\_rate, im\_agent\_occupancy\_rate, agent\_utilization\_rate, im\_agent\_utilization\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_in\_service\_incoming\_time, sum\_agents\_in\_service\_outcoming\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_custom\_1\_time, sum\_agents\_custom\_2\_time, sum\_agents\_custom\_3\_time, sum\_agents\_custom\_4\_time, sum\_agents\_custom\_5\_time, sum\_agents\_custom\_6\_time, sum\_agents\_custom\_7\_time, sum\_agents\_custom\_8\_time, sum\_agents\_custom\_9\_time, sum\_agents\_custom\_10\_time, sum\_agents\_banned\_time, im\_sum\_agents\_online\_time, im\_sum\_agents\_ready\_time, im\_sum\_agents\_in\_service\_time, im\_sum\_agents\_dnd\_time, im\_sum\_agents\_custom\_1\_time, im\_sum\_agents\_custom\_2\_time, im\_sum\_agents\_custom\_3\_time, im\_sum\_agents\_custom\_4\_time, im\_sum\_agents\_custom\_5\_time, im\_sum\_agents\_custom\_6\_time, im\_sum\_agents\_custom\_7\_time, im\_sum\_agents\_custom\_8\_time, im\_sum\_agents\_custom\_9\_time, im\_sum\_agents\_custom\_10\_time, im\_sum\_agents\_banned\_time, average\_agents\_idle\_time, max\_agents\_idle\_time, min\_agents\_idle\_time, percentile\_0\_25\_agents\_idle\_time, percentile\_0\_50\_agents\_idle\_time, percentile\_0\_75\_agents\_idle\_time, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, im\_min\_answer\_speed, im\_max\_answer\_speed, im\_average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime, count\_agent\_unanswered\_calls, im\_count\_agent\_unanswered\_chats, min\_reaction\_time, max\_reaction\_time, average\_reaction\_time, im\_min\_reaction\_time, im\_max\_reaction\_time, im\_average\_reaction\_time, im\_count\_abandonment\_chats, im\_count\_lost\_chats, im\_lost\_chats\_rate, call\_count\_assigned\_to\_queue, im\_count\_assigned\_to\_queue

The SmartQueue ID list with a maximum of 5 values separated by semicolons (;). Can operate as filter for the **calls\_blocked\_percentage**, **count\_blocked\_calls**, **average\_abandonment\_rate**, **count\_abandonment\_calls**, **service\_level**, **occupancy\_rate**, **min\_time\_in\_queue**, **max\_time\_in\_queue**, **average\_time\_in\_queue**, **min\_answer\_speed**, **max\_answer\_speed**, **average\_answer\_speed**, **min\_handle\_time**, **max\_handle\_time**, **average\_handle\_time**, **count\_handled\_calls**, **min\_after\_call\_worktime**, **max\_after\_call\_worktime**, **average\_after\_call\_worktime** report types

*optional*

The SmartQueue name list separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

The selected timezone or the 'auto' value (the account location)

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time

*optional*

The user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the **occupancy\_rate**, **sum\_agents\_online\_time**, **sum\_agents\_ready\_time**, **sum\_agents\_dialing\_time**, **sum\_agents\_in\_service\_time**, **sum\_agents\_afterservice\_time**, **sum\_agents\_dnd\_time**, **sum\_agents\_banned\_time**, **min\_handle\_time**, **max\_handle\_time**, **average\_handle\_time**, **count\_handled\_calls**, **min\_after\_call\_worktime**, **max\_after\_call\_worktime**, **average\_after\_call\_worktime** report types

*optional*

The user name list separated by semicolons (;). **user\_name** can be used instead of **user\_id**

### GetSmartQueueDayHistoryResponse

*optional*

The used timezone, e.g., 'Etc/GMT'

### GetSmartQueueRealtimeMetricsRequest

The application ID to search by

The application name to search by. Can be used instead of the **application\_id** parameter

*optional*

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 30 minutes

*optional*

Group the result by **agent** or *queue*. The **agent** grouping is allowed for 1 queue and for the occupancy\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_banned\_time, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types. The **queue** grouping allowed for the calls\_blocked\_percentage, count\_blocked\_calls, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, occupancy\_rate, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types

*optional*

Interval format: YYYY-MM-DD HH:mm:ss. Default is 30 minutes

*optional*

Maximum waiting time. Required for the **service\_level** report type

The report type. Possible values are: calls\_blocked\_percentage, count\_blocked\_calls, im\_blocked\_chats\_percentage, im\_count\_blocked\_chats, im\_answered\_chats\_rate, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, im\_service\_level, occupancy\_rate, im\_agent\_occupancy\_rate, agent\_utilization\_rate, im\_agent\_utilization\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_in\_service\_incoming\_time, sum\_agents\_in\_service\_outcoming\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_custom\_1\_time, sum\_agents\_custom\_2\_time, sum\_agents\_custom\_3\_time, sum\_agents\_custom\_4\_time, sum\_agents\_custom\_5\_time, sum\_agents\_custom\_6\_time, sum\_agents\_custom\_7\_time, sum\_agents\_custom\_8\_time, sum\_agents\_custom\_9\_time, sum\_agents\_custom\_10\_time, sum\_agents\_banned\_time, im\_sum\_agents\_online\_time, im\_sum\_agents\_ready\_time, im\_sum\_agents\_in\_service\_time, im\_sum\_agents\_dnd\_time, im\_sum\_agents\_custom\_1\_time, im\_sum\_agents\_custom\_2\_time, im\_sum\_agents\_custom\_3\_time, im\_sum\_agents\_custom\_4\_time, im\_sum\_agents\_custom\_5\_time, im\_sum\_agents\_custom\_6\_time, im\_sum\_agents\_custom\_7\_time, im\_sum\_agents\_custom\_8\_time, im\_sum\_agents\_custom\_9\_time, im\_sum\_agents\_custom\_10\_time, im\_sum\_agents\_banned\_time, average\_agents\_idle\_time, max\_agents\_idle\_time, min\_agents\_idle\_time, percentile\_0\_25\_agents\_idle\_time, percentile\_0\_50\_agents\_idle\_time, percentile\_0\_75\_agents\_idle\_time, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, im\_min\_answer\_speed, im\_max\_answer\_speed, im\_average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime, count\_agent\_unanswered\_calls, im\_count\_agent\_unanswered\_chats, min\_reaction\_time, max\_reaction\_time, average\_reaction\_time, im\_min\_reaction\_time, im\_max\_reaction\_time, im\_average\_reaction\_time, im\_count\_abandonment\_chats, im\_count\_lost\_chats, im\_lost\_chats\_rate, call\_count\_assigned\_to\_queue, im\_count\_assigned\_to\_queue

*optional*

The SmartQueue name list separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

The selected timezone or the 'auto' value (the account location)

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time

*optional*

The user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the **occupancy\_rate**, **sum\_agents\_online\_time**, **sum\_agents\_ready\_time**, **sum\_agents\_dialing\_time**, **sum\_agents\_in\_service\_time**, **sum\_agents\_afterservice\_time**, **sum\_agents\_dnd\_time**, **sum\_agents\_banned\_time**, **min\_handle\_time**, **max\_handle\_time**, **average\_handle\_time**, **count\_handled\_calls**, **min\_after\_call\_worktime**, **max\_after\_call\_worktime**, **average\_after\_call\_worktime** report types

*optional*

The user name list separated by semicolons (;). **user\_name** can be used instead of **user\_id**

### GetSmartQueueRealtimeMetricsResponse

*optional*

The used timezone, e.g., 'Etc/GMT'

### GetSmsHistoryRequest

*optional*

Maximum number of resulting rows fetched. Must be not bigger than 1000. If left blank, then the default value of 1000 is used

*optional*

The destination phone number

*optional*

Sent or received SMS. Possible values: 'IN', 'OUT', 'in, 'out'. Leave blank to get both incoming and outgoing messages

*optional*

Date from which to perform search. Format is 'yyyy-MM-dd HH:mm:ss', time zone is UTC

*optional*

The first **N** records are skipped in the output

*optional*

The output format. The following values available: **json**, **csv**, **xls**. The default value is **json**

*optional*

The source phone number

*optional*

*optional*

Date until which to perform search. Format is 'yyyy-MM-dd HH:mm:ss', time zone is UTC

### GetSmsHistoryResponse

*optional*

Total number of messages matching the query parameters

### GetSQAgentsResult

*optional*

Maximum number of chats that the user processes simultaneously

*optional*

JSON array of the agent's queues

*optional*

JSON array of the agent's skills

*optional*

Agent statuses info

*optional*

Display name of the user

*optional*

ID of the user

*optional*

Name of the user

### GetSQQueuesResult

*optional*

Number of agents bound to the queue

Agent selection strategy

*optional*

Maximum size of the queue with CALL-type requests

*optional*

Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent in minutes. If the value has been passed in seconds, this field is also present in the answer, rounded to the bigger number

*optional*

Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent in seconds. If the value has been passed in minutes, this field is also present in the answer

*optional*

UTC date of the queue creation in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Comment

*optional*

Whether the call task is kept in the queue if all agents are unavailable

*optional*

Whether the tasks are queued when there are no active agents

*optional*

Maximum size of the queue with IM-type requests

*optional*

Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent in minutes. If the value has been passed in seconds, this field is also present in the answer, rounded to the bigger number

*optional*

Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent in seconds. If the value has been passed in minutes, this field is also present in the answer

*optional*

UTC date of the queue modification in 24-h format: YYYY-MM-DD HH:mm:ss

ID of the SmartQueue

Name of the SmartQueue

Strategy of prioritizing requests for service

### GetSQSkillsResult

*optional*

UTC date of the queue creation in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Comment

*optional*

UTC date of the queue modification in 24-h format: YYYY-MM-DD HH:mm:ss

ID of the skill

Name of the skill

### GetSQStateRequest

The application ID to search by

*optional*

The application name to search by. Can be used instead of the **application\_id** parameter

The SmartQueue ID list separated by semicolons (;). Use the 'all' value to select all SmartQueues

*optional*

The SmartQueue name list separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

The selected timezone or the 'auto' value (the account location)

### GetSQStateResponse

*optional*

### GetTransactionHistoryAsyncRequest

*optional*

The child account ID list separated by semicolons (;). Use the 'all' value to select all child accounts

*optional*

Whether to get the children account transactions only

*optional*

Whether to get records in the descent order

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Whether to get transactions on hold (transactions for which money is reserved but not yet withdrawn from the account)

*optional*

The output format. The following values available: **csv**. The default value is **csv**

*optional*

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The transaction ID list separated by semicolons (;)

*optional*

The transaction type list separated by semicolons (;). The following values are possible: gift\_revoke, resource\_charge, money\_distribution, subscription\_charge, subscription\_installation\_charge, card\_periodic\_payment, card\_overrun\_payment, card\_payment, rub\_card\_periodic\_payment, rub\_card\_overrun\_payment, rub\_card\_payment, robokassa\_payment, gift, promo, adjustment, wire\_transfer, us\_wire\_transfer, refund, discount, mgp\_charge, mgp\_startup, mgp\_business, mgp\_big\_business, mgp\_enterprise, mgp\_large\_enterprise, techsupport\_charge, tax\_charge, monthly\_fee\_charge, grace\_credit\_payment, grace\_credit\_provision, mau\_charge, mau\_overrun, im\_charge, im\_overrun, fmc\_charge, sip\_registration\_charge, development\_fee, money\_transfer\_to\_child, money\_transfer\_to\_parent, money\_acceptance\_from\_child, money\_acceptance\_from\_parent, phone\_number\_installation, phone\_number\_charge, toll\_free\_phone\_number\_installation, toll\_free\_phone\_number\_charge, services, user\_money\_transfer, paypal\_payment, paypal\_overrun\_payment, paypal\_periodic\_payment

*optional*

The user ID list separated by semicolons (;)

*optional*

Whether to get the users' transactions only

*optional*

Whether to get a CSV file with the column names if the output=csv

### GetTransactionHistoryAsyncResponse

*optional*

The history report ID

Returns 1 if the request has been completed successfully

### GetTransactionHistoryRequest

*optional*

The child account ID list separated by semicolons (;). Use the 'all' value to select all child accounts

*optional*

Whether to get the children account transactions only

*optional*

The number of returning records. The maximum value is 1000

*optional*

Whether to get records in the descent order

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Whether to get transactions on hold (transactions for which money is reserved but not yet withdrawn from the account)

*optional*

The number of records to skip in the output with a maximum value of 10000

*optional*

*optional*

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The transaction ID list separated by semicolons (;)

*optional*

The transaction type list separated by semicolons (;). The following values are possible: gift\_revoke, resource\_charge, money\_distribution, subscription\_charge, subscription\_installation\_charge, card\_periodic\_payment, card\_overrun\_payment, card\_payment, rub\_card\_periodic\_payment, rub\_card\_overrun\_payment, rub\_card\_payment, robokassa\_payment, gift, promo, adjustment, wire\_transfer, us\_wire\_transfer, refund, discount, mgp\_charge, mgp\_startup, mgp\_business, mgp\_big\_business, mgp\_enterprise, mgp\_large\_enterprise, techsupport\_charge, tax\_charge, monthly\_fee\_charge, grace\_credit\_payment, grace\_credit\_provision, mau\_charge, mau\_overrun, im\_charge, im\_overrun, fmc\_charge, sip\_registration\_charge, development\_fee, money\_transfer\_to\_child, money\_transfer\_to\_parent, money\_acceptance\_from\_child, money\_acceptance\_from\_parent, phone\_number\_installation, phone\_number\_charge, toll\_free\_phone\_number\_installation, toll\_free\_phone\_number\_charge, services, user\_money\_transfer, paypal\_payment, paypal\_overrun\_payment, paypal\_periodic\_payment

*optional*

The user ID list separated by semicolons (;)

*optional*

Whether to get the users' transactions only

*optional*

Whether to include the 'total\_count' and increase performance

### GetTransactionHistoryResponse

The returned transaction count

*optional*

The used timezone. 'Etc/GMT' for example

The total found transaction count

### GetUsersRequest

*optional*

The ACD queue ID to filter

*optional*

The ACD status list separated by semicolons (;) to filter. The following values are possible: OFFLINE, ONLINE, READY, BANNED, IN\_SERVICE, AFTER\_SERVICE, TIMEOUT, DND

The application ID to filter

The application name part to filter

*optional*

The max returning record count

*optional*

The excluded ACD queue ID to filter

*optional*

The excluded skill ID to filter

*optional*

The first **N** records are skipped in the output

*optional*

The following values are available: 'user\_id', 'user\_name' and 'user\_display\_name'

*optional*

Whether to get the user live balance

*optional*

The skill to show in the 'skills' field output

*optional*

The skill ID to filter

*optional*

Whether the user is active to filter. Inactive users cannot log in to applications

*optional*

The user display name part to filter

*optional*

The user ID to filter

*optional*

The user name part to filter

*optional*

Whether to get the bound queues

*optional*

Whether to get the bound skills

### GetUsersResponse

The returned user count

*optional*

The UserInfoType records

The total found user count

### GetWABPhoneNumbersRequest

*optional*

Application ID that is bound to the WhatsApp Business phone number

*optional*

Bound application name that can be used instead of **application\_id**

*optional*

Maximum returning records count

*optional*

Country code filter (2 symbols) for the WhatsApp Business phone number

*optional*

Number of records to be skipped in the result

*optional*

WhatsApp Business phone number

### GetWABPhoneNumbersResponse

Number of returned records

*optional*

WhatsApp Business phone numbers info

Number of total records found

### HistoryInterface

Gets the account's brief call history in the asynchronous mode. Take a look at the `GetHistoryReports` and `DownloadHistoryReport` functions for downloading details.

Gets the account's call history (including call duration, cost, logs and other call information). You can filter the call history by a certain date.

The `GetCallHistory` asynchronous implementation. Use this function to download a large amounts of data. Take a look at the `GetHistoryReports` and `DownloadHistoryReport` functions for downloading details.

Gets the transaction history.

The `GetTransactionHistory` asynchronous implementation. Use this function to download a large amounts of data. Take a look at the `GetHistoryReports` and `DownloadHistoryReport` functions for downloading details.

### InvoicePeriod

From date in the following format: YYYY-MM-DD

To date in the following format: YYYY-MM-DD

### InvoicesInterface

Downloads the specified invoice.

Gets all invoices for the specified USD or EUR account.

### InvoiceSpendingDetails

Paid amount

Service name

Array of taxes

### InvoiceTaxesDetails

Paid amount

Tax category

Tax currency

Tax type. Possible values: Federal, State, County, City, Unincorporated

Tax name

Tax rate

Taxable sum

### InvoiceTotalDetails

Discounted amount to pay

Invoice currency

Discount

Total amount of taxes

Invoice total amount including taxes

### IsAccountPhoneNumberRequest

Phone number to check in the international format without `+`

### IsAccountPhoneNumberResponse

*optional*

Whether the number belongs to the account

### KeyValueItems

Expiration date based on **ttl** (timestamp without milliseconds)

Key that matches the specified key or key pattern

Value for the specified key

### KeyValueKeys

Expiration date based on **ttl** (timestamp without milliseconds)

Key that matches the pattern

### KeyValueStorageInterface

Deletes the specified key-value pair from the storage.

Gets the specified key-value pair from the storage.

Gets all the key-value pairs in which the keys begin with a pattern.

Gets all the keys of key-value pairs.

Creates or updates a key-value pair. If an existing key is passed, the method returns the existing item and changes the value if needed. The keys should be unique within a Voximplant application.

### OutboundTestNumbersInterface

Activates the phone number by the verification code.

Adds a personal phone number to test outgoing calls. Only one personal phone number can be used. To replace it with another, delete the existing one first.

Deletes the existing phone number.

Shows the phone number info.

Starts a call to the added phone number and pronounces a verification code. You have only 5 verification attempts per day and 100 in total. 1 minute should pass between 2 attempts.

### OutboundTestPhonenumberInfo

The country code

Whether the phone number is verified

The personal phone number

### PhoneNumbersInterface

Gets the account phone numbers.

Gets the asynchronous report regarding purchased phone numbers.

Checks if the phone number belongs to the authorized account.

### PstnBlackListInfo

The black list item ID

The phone number

### PSTNBlacklistInterface

Add a new phone number to the PSTN blacklist. Use blacklist to block incoming calls from specified phone numbers to numbers purchased from Voximplant. Since we have no control over exact phone number format for calls from SIP integrations, blacklisting such numbers should be done via JavaScript scenarios.

Remove phone number from the PSTN blacklist.

Get the whole PSTN blacklist.

Update the PSTN blacklist item. BlackList works for numbers that are purchased from Voximplant only. Since we have no control over exact phone number format for calls from SIP integrations, blacklisting such numbers should be done via JavaScript scenarios.

### QueueInfo

The ACD queue ID

The queue name

The integer queue priority. The highest priority is 0

*optional*

The application ID

Whether to enable the auto binding of operators to a queue by skills comparing

*optional*

The average service time in seconds. Specify the parameter to correct or initialize the waiting time prediction

The ACD queue creating UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The ACD queue deleting UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The maximum number of calls that can be enqueued into this queue

*optional*

The maximum predicted waiting time in minutes. When a call is going to be enqueued to the queue, its predicted waiting time should be less or equal to the maximum predicted waiting time; otherwise, a call would be rejected

The ACD queue editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

Number of agents bound to the queue

The value in the range of \[0.5 ... 1.0]. The value 1.0 means the service probability 100% in challenge with a lower priority queue

*optional*

The queue skills info

*optional*

The service level thresholds in seconds

*optional*

The queue users info

### QueuesInterface

Adds a new ACD queue.

Bind/unbind users to/from the specified ACD queues. Note that users and queues should be already bound to the same application.

Deletes the ACD queue.

Gets the current ACD queue state.

Gets the ACD queues.

Edits the ACD queue.

### QueueSkills

The skill ID

The skill name

### QueueUsers

The user ID

### Record

*optional*

The record cost

*optional*

The call duration in seconds

*optional*

The file size

The record ID

*optional*

The record name

*optional*

The record URL.  If you have issues accessing the record file, check if the application has "Secure storage of applications and logs" feature enabled. In this case, you need to `authorize`(/docs/guides/managementapi/secureobjects).

The start recording time in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

The transaction ID

*optional*

The status of transcription. The possible values are Not required, In progress, Complete

*optional*

Transcription URL. To open the URL, please add authorization parameters and **record\_id** to it

### RecordStorageInfo

*optional*

The record storage ID

*optional*

The record storage name

### RecordStoragesInterface

Gets the record storages.

### RequestSmartQueueHistoryRequest

The application ID to search by

The application name to search by. Can be used instead of the **application\_id** parameter

The from date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time minus 1 day

*optional*

Group the result by **agent** or *queue*. The **agent** grouping is allowed only for 1 queue and for the occupancy\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_banned\_time, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types. The **queue** grouping allowed for the calls\_blocked\_percentage, count\_blocked\_calls, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, occupancy\_rate, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime report types

*optional*

Interval format: YYYY-MM-DD HH:mm:ss. Default is 1 day

*optional*

Maximum waiting time. Required for the **service\_level** report type

The report type. Possible values are: calls\_blocked\_percentage, count\_blocked\_calls, im\_blocked\_chats\_percentage, im\_count\_blocked\_chats, im\_answered\_chats\_rate, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, im\_service\_level, occupancy\_rate, im\_agent\_occupancy\_rate, agent\_utilization\_rate, im\_agent\_utilization\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_in\_service\_incoming\_time, sum\_agents\_in\_service\_outcoming\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_custom\_1\_time, sum\_agents\_custom\_2\_time, sum\_agents\_custom\_3\_time, sum\_agents\_custom\_4\_time, sum\_agents\_custom\_5\_time, sum\_agents\_custom\_6\_time, sum\_agents\_custom\_7\_time, sum\_agents\_custom\_8\_time, sum\_agents\_custom\_9\_time, sum\_agents\_custom\_10\_time, sum\_agents\_banned\_time, im\_sum\_agents\_online\_time, im\_sum\_agents\_ready\_time, im\_sum\_agents\_in\_service\_time, im\_sum\_agents\_dnd\_time, im\_sum\_agents\_custom\_1\_time, im\_sum\_agents\_custom\_2\_time, im\_sum\_agents\_custom\_3\_time, im\_sum\_agents\_custom\_4\_time, im\_sum\_agents\_custom\_5\_time, im\_sum\_agents\_custom\_6\_time, im\_sum\_agents\_custom\_7\_time, im\_sum\_agents\_custom\_8\_time, im\_sum\_agents\_custom\_9\_time, im\_sum\_agents\_custom\_10\_time, im\_sum\_agents\_banned\_time, average\_agents\_idle\_time, max\_agents\_idle\_time, min\_agents\_idle\_time, percentile\_0\_25\_agents\_idle\_time, percentile\_0\_50\_agents\_idle\_time, percentile\_0\_75\_agents\_idle\_time, min\_time\_in\_queue, max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, im\_min\_answer\_speed, im\_max\_answer\_speed, im\_average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime, count\_agent\_unanswered\_calls, im\_count\_agent\_unanswered\_chats, min\_reaction\_time, max\_reaction\_time, average\_reaction\_time, im\_min\_reaction\_time, im\_max\_reaction\_time, im\_average\_reaction\_time, im\_count\_abandonment\_chats, im\_count\_lost\_chats, im\_lost\_chats\_rate, call\_count\_assigned\_to\_queue, im\_count\_assigned\_to\_queue

The SmartQueue ID list with a maximum of 5 values separated by semicolons (;). Can operate as filter for the **calls\_blocked\_percentage**, **count\_blocked\_calls**, **average\_abandonment\_rate**, **count\_abandonment\_calls**, **service\_level**, **occupancy\_rate**, **min\_time\_in\_queue**, **max\_time\_in\_queue**, **average\_time\_in\_queue**, **min\_answer\_speed**, **max\_answer\_speed**, **average\_answer\_speed**, **min\_handle\_time**, **max\_handle\_time**, **average\_handle\_time**, **count\_handled\_calls**, **min\_after\_call\_worktime**, **max\_after\_call\_worktime**, **average\_after\_call\_worktime** report types

*optional*

The SmartQueue name list separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

The selected timezone or the 'auto' value (the account location)

The to date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss. Default is the current time

*optional*

The user ID list with a maximum of 5 values separated by semicolons (;). Use the 'all' value to select all users. Can operate as a filter for the **occupancy\_rate**, **sum\_agents\_online\_time**, **sum\_agents\_ready\_time**, **sum\_agents\_dialing\_time**, **sum\_agents\_in\_service\_time**, **sum\_agents\_afterservice\_time**, **sum\_agents\_dnd\_time**, **sum\_agents\_banned\_time**, **min\_handle\_time**, **max\_handle\_time**, **average\_handle\_time**, **count\_handled\_calls**, **min\_after\_call\_worktime**, **max\_after\_call\_worktime**, **average\_after\_call\_worktime** report types

*optional*

The user name list separated by semicolons (;). Can be used instead of **user\_id**

### RequestSmartQueueHistoryResponse

*optional*

History report ID

Returns 1 if the request has been completed successfully

### ResourceUsage

*optional*

The resource cost

*optional*

The description

*optional*

The reference to call

*optional*

The resource quantity

The resource type. The possible values are CALLSESSION, VIDEOCALL, VIDEORECORD, VOICEMAILDETECTION, YANDEXASR, ASR, TRANSCRIPTION, TTS\_TEXT\_GOOGLE, TTS\_YANDEX, AUDIOHDCONFERENCE

The resource usage ID

The transaction ID

*optional*

The resource unit

The start resource using time in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

### RoleGroupView

The role group ID

The role group name

### RoleSystemInterface

Gets role groups.

### ScenariosInterface

Runs a session for video conferencing or joins the existing video conference session.

When you create a session by calling this method, a scenario runs on one of the servers dedicated to video conferencing. All further method calls with the same **conference\_name** do not create a new video conference session but join the existing one.

Use the `StartScenarios` method for creating audio conferences.

### SecretListItem

Secret creation timestamp

*optional*

Secret description

Secret modification timestamp

Secret ID

Secret name

### SecretsInterface

Adds a new secret.

Deletes an existing secret.

Gets the list of an application's secrets.

Gets the value of a specific secret.

Edits a secret's parameters.

### SendSmsMessageRequest

The destination phone number

The message text, up to 765 characters. We split long messages greater than 160 GSM-7 characters or 70 UTF-16 characters into multiple segments. Each segment is charged as one message

The source phone number

*optional*

Whether to store outgoing message texts. Default value is false

### SendSmsMessageResponse

*optional*

The number of fragments the message is divided into

Message ID

### SetAdminRoleInfoRequest

*optional*

Whether the admin role is enabled. If false the allowed and denied entries have no affect

The admin role to edit

The admin role to edit, can be used instead of **admin\_role\_id**

*optional*

The list of allowed access entry changes separated by semicolons (;) (the API function names)

*optional*

The list of denied access entry changes separated by semicolons (;) (the API function names)

*optional*

The modification mode of the permission lists (allowed\_entries and denied\_entries). The following values are possible: add, del, set

*optional*

The admin role ID list separated by semicolons (;). Use the 'all' value to select all admin roles. The list specifies the roles from which the allowed\_entries and denied\_entries are merged

*optional*

The admin role name, can be used instead of **like\_admin\_role\_id**. The name specifies a role from which the allowed\_entries and denied\_entries are merged

*optional*

The new admin role name. The length must be less than 50

### SetAdminRoleInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SetAdminUserInfoRequest

*optional*

Whether the admin user is active

*optional*

The new admin user display name. The length must be less than 256

*optional*

The new admin user name. The length must be less than 50

*optional*

The new admin user password. The length must be at least 6 symbols

The admin user to edit

The admin user to edit, can be used instead of **required\_admin\_user\_id**

### SetAdminUserInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SetApplicationInfoRequest

The application ID

*optional*

The new short application name in format \[a-z]\[a-z0-9-]\{1,79}

The application name that can be used instead of **application\_id**

*optional*

Whether to enable secure storage for all logs and records of the application

### SetApplicationInfoResponse

The new full application name

*optional*

Returns 1 if the request has been completed successfully

Whether a secure storage for logs and records is enabled or not

### SetDialogflowKeyRequest

The Dialogflow key's description. To clear previously set description leave the parameter blank or put whitespaces only

The Dialogflow key's ID

### SetDialogflowKeyResponse

*optional*

### SetKeyValueItemRequest

Application ID

*optional*

Application name

*optional*

Expiration date based on **ttl** (timestamp without milliseconds). Note that one of the two parameters (ttl or expires\_at) must be set

Key, up to 200 characters. A key can contain a namespace that is written before the ':' symbol, for example, test:1234. Thus, namespace 'test' can be used as a pattern in the `GetKeyValueItems`(/docs/references/httpapi/keyvaluestorage#getkeyvalueitems) and `GetKeyValueKeys`(/docs/references/httpapi/keyvaluestorage#getkeyvaluekeys) methods to find the keys with the same namespace.

The key should match the following regular expression: `^[a-zA-Z0-9а-яА-ЯёЁ_\-:;.#+]*$`

*optional*

Key expiry time in seconds. The value is in range of 0..7,776,000 (90 days), the default value is 30 days (2,592,000 seconds). The TTL is converted to an **expires\_at** Unix timestamp field as part of the storage object. Note that one of the two parameters (ttl or expires\_at) must be set

Value for the specified key, up to 2000 characters

### SetKeyValueItemResponse

*optional*

The key-value item

### SetPstnBlackListItemRequest

The PSTN black list item ID

The new phone number in format e164

### SetPstnBlackListItemResponse

*optional*

Returns 1 if the request has been completed successfully

### SetQueueInfoRequest

The ACD queue ID

The ACD queue name that can be used instead of **acd\_queue\_id**

*optional*

The integer queue priority. The highest priority is 0

*optional*

The new application ID

*optional*

Whether to enable the auto binding of operators to a queue by skills comparing

*optional*

The average service time in seconds. Specify the parameter to correct or initialize the waiting time prediction

*optional*

The max queue size

*optional*

The max predicted waiting time in minutes. The client is rejected if the predicted waiting time is greater than the max predicted waiting time

*optional*

The new queue name. The length must be less than 100

*optional*

The value in the range of \[0.5 ... 1.0]. The value 1.0 means the service probability 100% in challenge with a lower priority queue

### SetQueueInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SetSecretInfoRequest

Application ID

Application name. Can be used instead of **application\_id**

*optional*

Secret description. When processing, the length is truncated to the first 200 characters

*optional*

New secret name. The name must start with a Latin letter and can contain up to 64 characters, including Latin letters, digits and underscores

Secret ID to edit

Secret name. Can be used instead of **secret\_id**

*optional*

Secret value. Maximum length is 8192 characters

### SetSecretInfoResponse

*optional*

Returns 1 if the secret has been updated successfully

### SetSipWhiteListItemRequest

*optional*

The network address description

The SIP white list item ID

The new network address in format A.B.C.D/L or A.B.C.D/a.b.c.d (example 192.168.1.5/16)

### SetSipWhiteListItemResponse

*optional*

Returns 1 if the request has been completed successfully

### SetSkillInfoRequest

The new skill name. The length must be less than 512

The skill ID

The skill name that can be used instead of **skill\_id**

### SetSkillInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SetUserInfoRequest

*optional*

The application ID. It is required if the **user\_name** is specified

*optional*

The application name that can be used instead of **application\_id**

*optional*

*optional*

The new user name in format \[a-z0-9]\[a-z0-9\_-]\{2,49}

*optional*

Whether to use the parent account's money, 'false' to use a separate user balance

*optional*

Whether the user is active. Inactive users cannot log in to applications

*optional*

Any string

*optional*

The new user display name. The length must be less than 256

The user to edit

The user name that can be used instead of **user\_id**

*optional*

The new user password. Must be at least 8 characters long and contain at least one uppercase and lowercase letter, one number, and one special character

### SetUserInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SIPRegistration

*optional*

ID of the bound application

*optional*

Name of the bound application

*optional*

The SIP authentications user

Whether the subscription is deactivation. The SIP registration is frozen if true

*optional*

The error message from a SIP registration

Whether the SIP registration is persistent. Set false to activate it only on the user login

The last time updated

The next subscription renewal date in the following format: YYYY-MM-DD

*optional*

The outgoing proxy

The sip proxy

The purchase date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

ID of the bound rule

*optional*

Name of the bound rule

The SIP registration ID

The user name from sip proxy

*optional*

The status code from a SIP registration

The subscription monthly charge

*optional*

Whether the SIP registration is successful

*optional*

ID of the bound user

*optional*

Name of the bound user

### SIPRegistrationInterface

Bind the SIP registration to the application/user or unbind the SIP registration from the application/user. You should specify the application\_id or application\_name if you specify the rule\_name or user\_id, or user\_name. You should specify the sip\_registration\_id if you set bind=true. You can bind only one SIP registration to the user (the previous SIP registration is automatically unbound).

Get active SIP registrations.

### SipWhiteListInfo

*optional*

The network address description

The SIP white list item ID

The network address in format A.B.C.D/L

### SIPWhiteListInterface

Adds a new network address to the SIP white list.

Deletes the network address from the SIP white list.

Gets the SIP white list.

Edits the SIP white list.

### SkillInfo

The skill ID

The skill name

### SkillsInterface

Adds a new operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use [this reference](#how-auth-works).

Binds the specified skills to the users (ACD operators) and/or the ACD queues. Works only for ACDv1. For SmartQueue/ACDv2, use [this reference](#how-auth-works).

Deletes an operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use [this reference](#how-auth-works).

Gets the skills of an operator. Works only for ACDv1. For SmartQueue/ACDv2, use [this reference](#how-auth-works).

Edits an operator's skill. Works only for ACDv1. For SmartQueue/ACDv2, use [this reference](#how-auth-works).

### SmartQueueAgentSkill

The agent skill ID

The agent skill level

The agent skill name

### SmartQueueInterface

Gets the metrics for the specified SmartQueue for the last 2 days. Refer to the [SmartQueue reporting guide](/docs/guides/contact-center/reporting) to learn more.

Gets the metrics for the specified SmartQueue for the last 30 minutes. Refer to the [SmartQueue reporting guide](/docs/guides/contact-center/reporting) to learn more.

Gets the current state of the specified SmartQueue.

Gets history for the specified SmartQueue. Refer to the [SmartQueue reporting guide](/docs/guides/contact-center/reporting) to learn more.

Adds a new queue.

Adds a new skill to the app.

Binds agents to a queue.

Binds skills to agents.

Removes a mapping from the mapping table. If there is no such mapping, does nothing.

Deletes a queue.

Deletes a skill and detaches it from agents.

Returns the mapping list of SQ statuses and custom statuses. SQ statuses are returned whether they have mappings to custom statuses.

Gets agents.

Gets the queue(s).

Gets the skill(s).

Adds a status if there is no match for the given internal status and renames it if there is a match. It means that if the passed **sq\_status\_name** parameter is not in the mapping table, a new entry is created in there; if it is, the **name** field in its mapping is replaced with **custom\_status\_name**.

Edits the agent settings.

Edits an existing queue.

Edits an existing skill.

Unbinds agents from queues.

Unbinds skills from agents.

### SmartQueueMetricsGroups

*optional*

The SmartQueue ID

*optional*

The SmartQueue name

*optional*

The user display name

*optional*

The user ID

*optional*

The user name

The group values

### SmartQueueMetricsGroupsValues

The start of the period

The end of the period

The report value

### SmartQueueMetricsResult

Grouping by agent or queue

The report type(s). Possible values are calls\_blocked\_percentage, count\_blocked\_calls, average\_abandonment\_rate, count\_abandonment\_calls, service\_level, occupancy\_rate, sum\_agents\_online\_time, sum\_agents\_ready\_time, sum\_agents\_dialing\_time, sum\_agents\_in\_service\_time, sum\_agents\_afterservice\_time, sum\_agents\_dnd\_time, sum\_agents\_banned\_time, min\_time\_in\_queue,max\_time\_in\_queue, average\_time\_in\_queue, min\_answer\_speed, max\_answer\_speed, average\_answer\_speed, min\_handle\_time, max\_handle\_time, average\_handle\_time, count\_handled\_calls, min\_after\_call\_worktime, max\_after\_call\_worktime, average\_after\_call\_worktime, sum\_agents\_custom\_1\_time ... sum\_agents\_custom\_10\_time, call\_count\_assigned\_to\_queue, im\_count\_assigned\_to\_queue

### SmartQueueState

The list of logged-in agents with their skills and statuses

The SmartQueue ID

The SmartQueue name

The list of tasks

### SmartQueueStateAgent

Agent skills

Agent statuses info

The display user name

The user ID

The user name

### SmartQueueStateAgentStatus

The CALL status info

The IM status info

### SmartQueueStateAgentStatus\_

Time in 24-h format: YYYY-MM-DD HH:mm:ss

The status name

### SmartQueueStateTask

*optional*

Custom data text string for the current task. You can set the custom data in the `enqueueTask`(/docs/references/voxengine/voxengine/enqueuetask#enqueuetask) method

Processing time in ms

Task skills

The task status. Possible values are IN\_QUEUE, DISTRIBUTED, IN\_PROCESSING

The task type. Possible values are CALL, IM

*optional*

Selected agent

Waiting time in ms

### SmartQueueTaskSkill

The skill level

The skill name

### SmsHistory

Cost of the message

Number being called to

Incoming or outgoing message

*optional*

Error message (if any)

Number of fragments the initial message is divided into

Message ID

Date of message processing. The format is yyyy-MM-dd HH:mm:ss

Number being called from

Status of the message. The possible values are: 1 — Success, 2 — Error, 3 — Waiting

*optional*

Stored message text

*optional*

Id of the transaction for this message

### SMSInterface

Gets the history of sent/or received A2P SMS.

Sends an A2P SMS message from the application to customers. A SenderID is required for A2P messages. Please contact support for installing a SenderID.

Enables or disables sending and receiving SMS for the phone number. Can be used only for phone numbers with SMS support, which is indicated by the **is\_sms\_supported** property in the objects returned by the `GetPhoneNumbers` Management API. Each incoming SMS message is charged according to the `pricing`(//voximplant.com/pricing). If enabled, SMS can be sent from this phone number via the `SendSmsMessage` Management API and received via the `InboundSmsCallback` property of the HTTP callback. See [this article](/docs/guides/managementapi/callbacks) for HTTP callback details.

Gets the history of sent and/or received SMS.

Sends an SMS message between two phone numbers. The source phone number should be purchased from Voximplant and support SMS (which is indicated by the **is\_sms\_supported** property in the objects returned by the `GetPhoneNumbers` Management API) and SMS should be enabled for it via the `ControlSms` Management API. SMS messages can be received via HTTP callbacks, see [this article](/docs/guides/managementapi/callbacks) for details.

### SmsTransaction

The SMS destination number

Message ID

### SQ\_AddQueueRequest

Application ID to bind to

*optional*

Application name to bind to. Can be used instead of **application\_id**

Agent selection strategy for calls. Accepts one of the following values: "MOST\_QUALIFIED", "LEAST\_QUALIFIED", "MAX\_WAITING\_TIME"

*optional*

Maximum size of the queue with CALL-type requests

*optional*

Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent. Specify either this parameter or `call_max_waiting_time_in_seconds`. Specifying both parameters simultaniously leads to an error

*optional*

Maximum call waiting time in seconds. Specify either this parameter or `call_max_waiting_time`. Specifying both parameters simultaniously leads to an error

Call type requests prioritizing strategy. Accepts one of the `SQTaskSelectionStrategies` enum values

*optional*

Comment, up to 200 characters

*optional*

*optional*

Whether to keep the call task in the queue if all agents are in the DND/BANNED/OFFLINE statuses.

*optional*

Whether to add the task to the queue if there are no available agents

*optional*

Agent selection strategy for messages. Accepts one of the following values: "MOST\_QUALIFIED", "LEAST\_QUALIFIED", "MAX\_WAITING\_TIME". The default value is **call\_agent\_selection**

*optional*

Maximum size of the queue with IM-type requests

*optional*

Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent. Specify either this parameter or `im_max_waiting_time_in_seconds`. Specifying both parameters simultaniously leads to an error

*optional*

Maximum chat message waiting time in seconds. Specify either this parameter or `im_max_waiting_time`. Specifying both parameters simultaniously leads to an error

*optional*

IM type requests prioritizing strategy. Accepts one of the `SQTaskSelectionStrategies` enum values. The default value is **call\_task\_selection**

*optional*

The queue's priority from 1 to 100

Unique SmartQueue name within the application, up to 100 characters

### SQ\_AddQueueResponse

*optional*

Result with ID of the added queue

### SQ\_AddSkillRequest

Application ID to bind to

*optional*

Application name to bind to. Can be used instead of **application\_id**

*optional*

Comment, up to 200 characters

Unique skill name within the application

### SQ\_AddSkillResponse

*optional*

Result with ID of the added skill

### SQ\_BindAgentRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Binding mode. Accepts one of the `SQAgentBindingModes` enum values

ID of the SmartQueue. Pass a list of values divided by ; or the "all" keyword

*optional*

Name of the SmartQueue. Pass a list of names divided by ; or the "all" keyword

List of user IDs separated by semicolons (;). Use 'all' to select all the users

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_BindAgentResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_BindSkillRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Binding mode. Accepts one of the `SQSkillBindingModes` enum values

Skills to be bound to agents in the json array format. The array should contain objects with the **sq\_skill\_id**/**sq\_skill\_name** and **sq\_skill\_level** keys where skill levels range from 1 to 5

List of user IDs separated by semicolons (;). Use 'all' to select all the users

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_BindSkillResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_DeleteAgentCustomStatusMappingRequest

Application ID

*optional*

Status name

### SQ\_DeleteAgentCustomStatusMappingResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_DelQueueRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

List of SmartQueue IDs separated by semicolons (;). Use 'all' to delete all the queues

*optional*

List of SmartQueue names separated by semicolons (;). Can be used instead of **sq\_queue\_id**

### SQ\_DelQueueResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_DelSkillRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

List of skill IDs separated by semicolons (;). Use 'all' to delete all the skills

*optional*

List of skill names separated by semicolons (;). Can be used instead of **sq\_skill\_id**

### SQ\_DelSkillResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_GetAgentCustomStatusMappingRequest

*optional*

Application ID

### SQ\_GetAgentCustomStatusMappingResponse

Custom status name

*optional*

Status name

### SQ\_GetAgentsRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Number of items to show in the output

*optional*

ID of the SmartQueue to exclude

*optional*

Name of the SmartQueue to exclude. Can be used instead of **excluded\_sq\_queue\_id**

Whether the agent can handle calls. When set to false, the agent is excluded from the CALL-request distribution

*optional*

Number of items to skip in the output

*optional*

List of SmartQueue IDs separated by semicolons (;). Use 'all' to select all the queues

*optional*

List of SmartQueue names separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

Skills to filter in the json array format. The array should contain objects with the **sq\_skill\_id**/**sq\_skill\_name**, **min\_sq\_skill\_level**, and **max\_sq\_skill\_level** keys where skill levels range from 1 to 5

*optional*

Filter statuses in the json array format. The array should contain objects with the **sq\_status\_type** and **sq\_status\_name** keys. Possible values for **sq\_status\_type** are 'CALL' and 'IM'. Possible values for **sq\_status\_name** are 'OFFLINE', 'ONLINE', 'READY', 'IN\_SERVICE', 'AFTER\_SERVICE', 'DND'

*optional*

List of user IDs separated by semicolons (;)

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

*optional*

Substring of the user name to filter

*optional*

Whether to display agent queues

*optional*

Whether to display agent skills

*optional*

Whether to display agent current statuses

### SQ\_GetAgentsResponse

*optional*

The found agent(s)

### SQ\_GetQueuesRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Number of items to show in the output

*optional*

ID of the user that is not bound to the queue

*optional*

Name of the user that is not bound to the queue. Can be used instead of **excluded\_user\_id**

*optional*

Number of items to skip in the output

*optional*

List of SmartQueue IDs separated by semicolons (;)

*optional*

List of SmartQueue names separated by semicolons (;). Can be used instead of **sq\_queue\_id**

*optional*

Substring of the SmartQueue name to filter

*optional*

ID of the user that is bound to the queue

*optional*

Name of the user that is bound to the queue. Can be used instead of **user\_id**

*optional*

Whether to include the number of agents bound to the queue

### SQ\_GetQueuesResponse

*optional*

The found queue(s)

### SQ\_GetSkillsRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Number of items to show in the output

*optional*

ID of the user that is not bound to the skill

*optional*

Name of the user that is not bound to the skill. Can be used instead of **excluded\_user\_id**

*optional*

Number of items to skip in the output

*optional*

List of skill IDs separated by semicolons (;)

*optional*

List of skill names separated by semicolons (;). Can be used instead of **sq\_skill\_id**

*optional*

Substring of the skill name to filter, case-insensitive

*optional*

List of user IDs separated by semicolons (;)

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_GetSkillsResponse

*optional*

The found skill(s).

### SQ\_SetAgentCustomStatusMappingRequest

Application ID

Custom status name

Status name

### SQ\_SetAgentCustomStatusMappingResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_SetAgentInfoRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

Whether the agent can handle calls. When set to false, the agent is excluded from the CALL-request distribution

*optional*

Maximum number of chats that the user processes simultaneously

List of user IDs separated by semicolons (;). Use 'all' to select all the users

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_SetAgentInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_SetQueueInfoRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Agent selection strategy for calls. Accepts one of the following values: "MOST\_QUALIFIED", "LEAST\_QUALIFIED", "MAX\_WAITING\_TIME"

*optional*

Maximum size of the queue with CALL-type requests

*optional*

Maximum time in minutes that a CALL-type request can remain in the queue without being assigned to an agent. Specify either this parameter or `call_max_waiting_time_in_seconds`. Specifying both parameters simultaniously leads to an error

*optional*

Maximum call waiting time in seconds. Specify either this parameter or `call_max_waiting_time`. Specifying both parameters simultaniously leads to an error

*optional*

Strategy of prioritizing CALL-type requests for service. Accepts one of the following values: "MAX\_PRIORITY", "MAX\_WAITING\_TIME"

*optional*

Comment, up to 200 characters

*optional*

*optional*

Whether to keep the call task in the queue if all agents are in the DND/BANNED/OFFLINE statuses.

*optional*

Whether to add the task to the queue if there are no available agents

*optional*

Agent selection strategy for messages. Accepts one of the following values: "MOST\_QUALIFIED", "LEAST\_QUALIFIED", "MAX\_WAITING\_TIME". The default value is **call\_agent\_selection**

*optional*

Maximum size of the queue with IM-type requests

*optional*

Maximum time in minutes that an IM-type request can remain in the queue without being assigned to an agent. Specify either this parameter or `im_max_waiting_time_in_seconds`. Specifying both parameters simultaniously leads to an error

*optional*

Maximum chat message waiting time in seconds. Specify either this parameter or `im_max_waiting_time`. Specifying both parameters simultaniously leads to an error

*optional*

Strategy of prioritizing IM-type requests for service. Accepts one of the following values: "MAX\_PRIORITY", "MAX\_WAITING\_TIME". The default value is **call\_task\_selection**

*optional*

New SmartQueue name within the application, up to 100 characters

*optional*

The queue's priority from 1 to 100

ID of the SmartQueue to search for

*optional*

Name of the SmartQueue to search for. Can be used instead of **sq\_queue\_id**

### SQ\_SetQueueInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_SetSkillInfoRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

*optional*

Comment, up to 200 characters

*optional*

New unique skill name within the application

ID of the skill

*optional*

Name of the skill. Can be used instead of **sq\_skill\_id**

### SQ\_SetSkillInfoResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_UnbindAgentRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

List of SmartQueue IDs separated by semicolons (;). Use 'all' to select all the queues

*optional*

List of SmartQueue names separated by semicolons (;). Can be used instead of **sq\_queue\_id**

List of user IDs separated by semicolons (;). Use 'all' to select all the users

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_UnbindAgentResponse

*optional*

Returns 1 if the request has been completed successfully

### SQ\_UnbindSkillRequest

Application ID to search by

*optional*

Application name to search by. Can be used instead of **application\_id**

List of skill IDs separated by semicolons (;). Use 'all' to unbind all the skills

*optional*

List of skill names separated by semicolons (;). Can be used instead of **sq\_skill\_id**

List of user IDs separated by semicolons (;). Use 'all' to select all the users

*optional*

List of user names separated by semicolons (;). Can be used instead of **user\_id**

### SQ\_UnbindSkillResponse

*optional*

Returns 1 if the request has been completed successfully

### SQAddQueueResult

ID of the added queue

### SQAddSkillResult

ID of the added skill

### StartConferenceRequest

*optional*

The application ID

*optional*

The application name that can be used instead of **application\_id**

The conference name. The name length must be less than 50 symbols

*optional*

Specifies the IP from the geolocation of predicted subscribers. It allows selecting the nearest server for serving subscribers

The rule ID that needs to be launched. Please note, the necessary scenario needs to be attached to the rule

*optional*

The script custom data, that can be accessed in the scenario via the [VoxEngine.customData()](/docs/references/voxengine/voxengine/customdata) method. Use the application/x-www-form-urlencoded content type with UTF-8 encoding.

*optional*

Specifies the location of the server where the scenario needs to be executed. Has higher priority than `reference_ip`. Request `getServerLocations`([https://api.voximplant.com/getServerLocations](https://api.voximplant.com/getServerLocations)) for possible values

*optional*

The user ID. Run the scripts from the user if set

*optional*

The user name that can be used instead of **user\_id**. Run the scripts from the user if set

### StartConferenceResponse

The call session history ID. To search a call session result, paste the ID to the `GetCallHistory`(/docs/references/httpapi/history#getcallhistory) method's **call\_session\_history\_id** parameter

*optional*

The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTPS request on this URL results in the `AppEvents.HttpRequest`(/docs/references/voxengine/appevents#httprequest) VoxEngine event being triggered for a scenario, with an HTTP request data passed to it

The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTP request on this URL results in the `AppEvents.HttpRequest`(/docs/references/voxengine/appevents#httprequest) VoxEngine event being triggered for a scenario, with an HTTP request data passed to it

Returns 1 if the request has been completed successfully

### TransactionInfo

The account ID

The transaction amount, \$

The amount currency (USD, RUR, EUR, ...).

The transaction date in the selected timezone in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The transaction description

The transaction ID

The transaction type. The following values are possible: gift\_revoke, resource\_charge, money\_distribution, subscription\_charge, subscription\_installation\_charge, card\_periodic\_payment, card\_overrun\_payment, card\_payment, rub\_card\_periodic\_payment, rub\_card\_overrun\_payment, rub\_card\_payment, robokassa\_payment, gift, promo, adjustment, wire\_transfer, us\_wire\_transfer, refund, discount, mgp\_charge, mgp\_startup, mgp\_business, mgp\_big\_business, mgp\_enterprise, mgp\_large\_enterprise, techsupport\_charge, tax\_charge, monthly\_fee\_charge, grace\_credit\_payment, grace\_credit\_provision, mau\_charge, mau\_overrun, im\_charge, im\_overrun, fmc\_charge, sip\_registration\_charge, development\_fee, money\_transfer\_to\_child, money\_transfer\_to\_parent, money\_acceptance\_from\_child, money\_acceptance\_from\_parent, phone\_number\_installation, phone\_number\_charge, toll\_free\_phone\_number\_installation, toll\_free\_phone\_number\_charge, services, user\_money\_transfer, paypal\_payment, paypal\_overrun\_payment, paypal\_periodic\_payment

### UserInfo

*optional*

The bound ACD queues

*optional*

The ACD operator status. The following values are possible: OFFLINE, ONLINE, READY, BANNED, IN\_SERVICE, AFTER\_SERVICE, TIMEOUT, DND

The ACD status changing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

The bound applications

The current user's money in the currency specified for the account. The value is the number rounded to 4 decimal places. The parameter is the alias to live\_balance by default. But there is a possibility to make the alias to fixed\_balance: just to pass return\_live\_balance=false into the `GetAccountInfo` method

The user editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

The last committed balance which has been approved by billing's transaction

The current user's money in the currency specified for the account. The value is the number rounded to 4 decimal places, and it changes during the calls, transcribing, purchases etc

The user editing UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

Whether the user uses the parent account's money, 'false' if the user has a separate balance

*optional*

The bound skills

Whether the user is active. Inactive users cannot log in to applications

*optional*

The custom data

The display user name

The user ID

The user name

### UsersInterface

Adds a new user.

Deletes the specified user(s).

Shows the users of the specified account.

Edits the user.

### VerifyOutboundTestPhoneNumberRequest

### VerifyOutboundTestPhoneNumberResponse

The number of attempts left for the day. The number is reset every day at 00:00 UTC

*optional*

### WABPhoneInfo

*optional*

ID of the bound application

*optional*

Name of the bound application

The WhatsApp Business country code (2 symbols)

UTC date in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

WhatsApp Business phone number description

*optional*

Full application name, e.g. myapp.myaccount.n1.voximplant.com

UTC date of an event associated with the number in 24-h format: YYYY-MM-DD HH:mm:ss

*optional*

ID of the bound rule

*optional*

Name of the bound rule

WhatsApp Business phone number

### WABPhoneNumbersInterface

Gets the account's WhatsApp Business phone numbers.