{
  "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"
}