{
  "answer_time": "2022-06-28 19:39:05+05:30", // Local time zone as updated in the Plivo console
  "bill_duration": 11,
  "billed_duration": 60,
  "call_direction": "inbound",
  "call_duration": 11,
  "call_uuid": "57a1b60a-5c0b-11e7-9082-ef888d0400e9",
  "end_time": "2022-06-28 19:39:15+05:30", // Local time zone as updated in the Plivo console
  "from_number": "12025551111",
  "initiation_time": "2022-06-28 19:39:04+05:30", // Local time zone as updated in the Plivo console
  "parent_call_uuid": null,
  "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Call/57a1b60a-5c0b-11e7-9082-ef888d0400e9/",
  "to_number": "19172592277",
  "total_amount": "0.00850",
  "total_rate": "0.00850",
  "hangup_cause_name": "End Of XML Instructions",
  "hangup_cause_code":4010,
  "hangup_source":"Plivo",
  "source_ip": "92.168.0.1"
}

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

FieldTypeDescription
answer\_timestringThe timestamp when the call was answered.
Timezone: Local timezone as set in the Plivo console
Format: yyyy-MM-dd HH:mm:ss
bill\_durationintegerThe duration of the call in seconds.
billed\_durationintegerThe billed duration of the call in seconds. May differ from bill_duration depending on the billing interval of the destination.
call\_directionstringDirection of the call — either outbound or inbound.
call\_durationintegerDuration of the call in seconds.
call\_uuidstringUnique identifier for the call.
end\_timestringThe timestamp when the call ended.
Timezone: Local timezone as set in the Plivo console
Format: yyyy-MM-dd HH:mm:ss
from\_numberstringCaller ID used to initiate the call.
initiation\_timestringThe timestamp when the call was initiated.
Timezone: Local timezone as set in the Plivo console
Format: yyyy-MM-dd HH:mm:ss
parent\_call\_uuidstringUUID of the A-leg of the call.
resource\_uristringURI of the requested resource.
stir\_verificationstringSTIR/SHAKEN attestation info:

Outbound: Attestation assigned by Plivo.
Inbound: Attestation received on the inbound call to your Plivo number.

Possible values:
  • Verified: Call is from a verified caller (Attestation A).
  • Not Verified: Caller is not verified or uncertain (Attestation B or C).
  • Not Applicable: STIR/SHAKEN doesn’t apply (e.g. non-US calls, cloud calls).
Read more about STIR/SHAKEN
to\_numberstringNumber to which the call was initiated.
total\_amountstringTotal amount charged for the call.
total\_ratestringPer-minute rate based on the destination number.
hangup\_cause\_namestringReason the call was hung up. See hangup causes
hangup\_cause\_codeintegerInteger code for the hangup cause. See hangup causes
hangup\_sourcestringEntity that triggered the hangup. Possible sources: Caller, Callee, Plivo, API Request, Answer XML, Error, Unknown. See hangup causes
source\_ipstringIP address from which the call request originated. Useful for monitoring misuse or unauthorized access.
{
  "answer_time": "2022-06-28 19:39:05+05:30", // Local time zone as updated in the Plivo console
  "bill_duration": 11,
  "billed_duration": 60,
  "call_direction": "inbound",
  "call_duration": 11,
  "call_uuid": "57a1b60a-5c0b-11e7-9082-ef888d0400e9",
  "end_time": "2022-06-28 19:39:15+05:30", // Local time zone as updated in the Plivo console
  "from_number": "12025551111",
  "initiation_time": "2022-06-28 19:39:04+05:30", // Local time zone as updated in the Plivo console
  "parent_call_uuid": null,
  "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Call/57a1b60a-5c0b-11e7-9082-ef888d0400e9/",
  "to_number": "19172592277",
  "total_amount": "0.00850",
  "total_rate": "0.00850",
  "hangup_cause_name": "End Of XML Instructions",
  "hangup_cause_code":4010,
  "hangup_source":"Plivo",
  "source_ip": "92.168.0.1"
}