Getting a list of virtual number groups
| Method | get.virtual_number_groups | 
|---|---|
| Description | Getting a list of virtual number groups | 
| Who has access | Agent, Customer | 
Parameters of a request
| Title | Type | Required | Description | 
|---|---|---|---|
| access_token | string | yes | Authentication session key | 
| user_id | number | no | Unique ID of an agent's customer user who makes request Is required for agentTo access a list of customer users, use the method "get.customer_users" | 
| limit | number | no | Returning entries count. Refer to "Paging" | 
| offset | number | no | Offset that defines from which number to return the entries "limit". Default value is "0". Refer to "Paging" | 
| filter | object | no | Refer to "Filters" | 
| fields | array | no | Refer to "Viewing returning data" | 
| sort | array | no | Refer to "Data sorting" | 
Parameters of a reply
| Title | Type | Valid values | Filtering | Sorting | Description | 
|---|---|---|---|---|---|
| id | number | yes | yes | Virtual number group unique ID | |
| name | string | yes | yes | Virtual number group name | |
| number | string | yes | yes | Virtual number group unique identifier (number): g1,g2,g3,... | |
| Employees | |||||
| employees | array | ||||
| id | number | Employee ID See method get.employees | |||
| full_name | string | Employee full name | |||
| Employee groups | |||||
| employee_groups | array | ||||
| id | number | Group ID See method get.group_employees | |||
| name | string | Group name | |||
| Virtual phones | |||||
| virtual_phones | array | ||||
| id | number | Virtual phone ID. See method get.virtual_numbers | |||
| number | string | Virtual phone number | |||
JSON request structure
{
  "jsonrpc":"2.0",
  "id":"number",
  "method":"get.virtual_number_groups",
  "params":{
    "access_token":"string",
    "user_id":"number",
    "offset":"number",
    "limit":"number",
    "filter":{
    },
    "sort":[
      {
        "field":"string",
        "order":"string"
      }
    ],
    "fields":[
      "string"
    ]
  }
}
JSON reply structure
{
  "jsonrpc": "2.0",
  "id": "number",
  "result": {
    "metadata": {
    },
    "data": [
      {
        "id": "number",
        "name": "string",
        "number": "string",
        "employees": [
          {
            "id": "number",
            "full_name": "string"
          }
        ],
        "virtual_phones": [
          {
            "id": "number",
            "number": "string"
          }
        ],
        "employee_groups": [
          {
            "id": "number",
            "name": "string"
          }
        ]
      }
    ]
  }
}
List of returning errors
Refer to the section "List of errors for the methods with the verb get"