Call
The Call object
A Call
object is created when an outbound call is initiated or when an inbound call is received. You can use the Call
object to interact with ongoing calls, retrieve details about completed calls, and transfer ongoing calls, thereby building custom call flows.
Attributes
Field | Type | Description |
---|---|---|
answer\_time | string | The timestamp when the call was answered. Timezone: Local timezone as set in the Plivo console Format: yyyy-MM-dd HH:mm:ss |
bill\_duration | integer | The duration of the call in seconds. |
billed\_duration | integer | The billed duration of the call in seconds. May differ from bill_duration depending on the billing interval of the destination. |
call\_direction | string | Direction of the call — either outbound or inbound . |
call\_duration | integer | Duration of the call in seconds. |
call\_uuid | string | Unique identifier for the call. |
end\_time | string | The timestamp when the call ended. Timezone: Local timezone as set in the Plivo console Format: yyyy-MM-dd HH:mm:ss |
from\_number | string | Caller ID used to initiate the call. |
initiation\_time | string | The timestamp when the call was initiated. Timezone: Local timezone as set in the Plivo console Format: yyyy-MM-dd HH:mm:ss |
parent\_call\_uuid | string | UUID of the A-leg of the call. |
resource\_uri | string | URI of the requested resource. |
stir\_verification | string | STIR/SHAKEN attestation info: Outbound: Attestation assigned by Plivo. Inbound: Attestation received on the inbound call to your Plivo number. Possible values:
|
to\_number | string | Number to which the call was initiated. |
total\_amount | string | Total amount charged for the call. |
total\_rate | string | Per-minute rate based on the destination number. |
hangup\_cause\_name | string | Reason the call was hung up. See hangup causes |
hangup\_cause\_code | integer | Integer code for the hangup cause. See hangup causes |
hangup\_source | string | Entity that triggered the hangup. Possible sources: Caller , Callee , Plivo , API Request , Answer XML , Error , Unknown . See hangup causes |
source\_ip | string | IP address from which the call request originated. Useful for monitoring misuse or unauthorized access. |