Calls (/calls/)
- esnata (Unlicensed)
- Ilya Titaev
- Evgeniy
You can test API methods in the interactive API browser page and without writing any code
Some resources described in the page may not be available by default due to the application type (see Creating and authorizing applications)
This resource allows you to get client call data. This resource is similar to the resource call_history, except for absence of an array of call data records (cdr). It is faster than call_history, so it is preferable to use it when the call data records are not important.
Description of Data Structures
Resource calls
Name | Type | Mandatory | Description |
---|
Name | Type | Mandatory | Description |
---|---|---|---|
bridged_domain | string | no | User domain of the subscriber whom the connection has been established with |
bridged_duration | long | no | Duration of connection of two subscribers. May be null if no connection with the second subscriber has not been established |
bridged_time_gmt | string | no | UTC time when two subscribers were connected. May be null if no connection with the second subscriber has been established |
bridged_username | string | no | Number of the subscriber whom the connection has been established with |
call_uuid | string | no | Unique call identifier |
client_owner_id | long | no | Identifier of the client whom the call belongs to |
did_domain | string | no | External number domain (DID – Direct Inward Dialing), which the call entered to |
did_number | string | no | External number (DID – Direct Inward Dialing), which the call entered to |
duration | long | no | Call duration |
ext_number_reg | string | no | The external number of the extension number, which the call belongs to, if the extension number has an external number registration. Otherwise, the field has the value null |
extension_group_owner_id | long | no | Group identifier of the extension number, which the call belongs to. May be null if the extension number was not a member of any group at the time of the call |
extension_id | long | no | Identifier of the extension number, which the call belongs to. |
extension_name | string | no | Name of the extension number, which the call belongs to. |
extension_type | string | no | Type of the extension number, which the call belongs to. |
flow | string | no | Call direction. May take the value in or out |
from_domain | string | no | Caller domain |
from_screen_name | string | no | Caller name |
from_username | string | no | Caller number |
hangup_cause | string | no | Reason of the call end (field may be ignored, it is used for backward compatibility) |
hangup_disposition | string | no | Used to determine the disconnection initiator:
|
hangup_time_gmt | string | no | Call end UTC time |
init_time_gmt | string | no | Call start UTC time |
result | string | no | Call result. Can take the following values:
|
start_time_gmt | string | no | UTC time when the call was answered. May be null if the call was not answered |
to_domain | string | no | Callee domain |
to_username | string | no | Callee number |
diversion_number | string | no | Number from diversion header value |
quality_rate | object | no | Conversation rate: {rate: int, max_rate: int} rate - rate, max_rate - maximum possible rate |
ivr_history | string | no | Contains history of caller jumps in IVR with format:
example of ivr_history string: 1,invalid,64; - was appeared in context with id 1 in option invalid and 64 was dialed from caller |
callback | object | no | Contains information if a callback was made.
|
"Client" Section Resources
GET /client/{client_id}/calls/
URL Options
Name | Type |
---|
Name | Type |
---|---|
client_id | string |
Request Options
Name | Type |
---|
Name | Type |
---|---|
start_datetime | string |
from_username | array [string] |
start_bridged_duration | integer |
flow | array [string] |
bridged_username | array [string] |
end_bridged_duration | integer |
order | string |
end_datetime | string |
did_number | array [string] |
per_page | integer |
end_duration | integer |
extension_id | array [integer] |
to_username | array [string] |
start_duration | integer |
page | integer |
Response Fields
Name | Type |
---|
Name | Type |
---|---|
calls | Array[calls] |
order | string |
page | long |
per_page | long |
Resource calls
Name | Type |
---|
Name | Type |
---|---|
bridged_domain | string |
bridged_duration | long |
bridged_time_gmt | string |
bridged_username | string |
call_uuid | string |
client_owner_id | long |
did_domain | string |
did_number | string |
duration | long |
ext_number_reg | string |
extension_group_owner_id | long |
extension_id | long |
extension_name | string |
extension_type | string |
flow | string |
from_domain | string |
from_screen_name | string |
from_username | string |
hangup_cause | string |
hangup_disposition | string |
hangup_time_gmt | string |
init_time_gmt | string |
result | string |
start_time_gmt | string |
to_domain | string |
to_username | string |