Get user's call logs

GET {{baseUrl}}/phone/users/:userId/call_logs?page_size=30&from=<date>&to=<date>&type=all&next_page_token=<string>&phone_number=<string>&time_type=startTime

Gets a user's Zoom phone call logs. For user-level apps, pass the me value instead of the userId parameter.

Prerequisites: * A Business or Enterprise account * A Zoom Phone license

Scopes: phone:read:admin,phone_call_log:read:admin,phone:read,phone_call_log:read

Granular Scopes: phone:read:list_call_logs,phone:read:list_call_logs:admin

Rate Limit Label: Heavy

Request Params

KeyDatatypeRequiredDescription
page_sizenumberThe number of records returned within a single API call.
fromstringThe start time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format. The date range defined by the from and to parameters should be a month as the response only includes one month's worth of data. The month defined should fall within the last six months. If unspecified, returns data within the 24 hours.
tostringRequired only when the from parameter is specified. End time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format, the same format as the from parameter.
typestring
next_page_tokenstringThe next page token paginates through a large set of results. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.
phone_numberstringFilter API responses to include call logs of only the phone number defined in this field.
time_typestringEnables you to sort call logs by start or end time. Choose the sort time value. Values include startTime or endTime.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;call_logs&quot;:[{&quot;accepted_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;answer_start_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;call_end_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;call_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_did_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_number_type&quot;:2,&quot;callee_number_source&quot;:&quot;internal&quot;,&quot;caller_country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_did_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_number_type&quot;:2,&quot;caller_number_source&quot;:&quot;external&quot;,&quot;caller_billing_reference_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;charge&quot;:&quot;\u003cstring\u003e&quot;,&quot;client_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;date_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;direction&quot;:&quot;\u003cstring\u003e&quot;,&quot;duration&quot;:&quot;\u003cinteger\u003e&quot;,&quot;forwarded_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;extension_type&quot;:&quot;callQueue&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;forwarded_to&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;has_recording&quot;:&quot;\u003cboolean\u003e&quot;,&quot;has_voicemail&quot;:&quot;\u003cboolean\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;outgoing_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;path&quot;:&quot;\u003cstring\u003e&quot;,&quot;rate&quot;:&quot;\u003cstring\u003e&quot;,&quot;recording_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;result&quot;:&quot;\u003cstring\u003e&quot;,&quot;site&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;hold_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;waiting_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;department&quot;:&quot;\u003cstring\u003e&quot;,&quot;cost_center&quot;:&quot;\u003cstring\u003e&quot;},{&quot;accepted_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;answer_start_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;call_end_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;call_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_did_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;callee_number_type&quot;:1,&quot;callee_number_source&quot;:&quot;internal&quot;,&quot;caller_country_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_did_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;caller_number_type&quot;:2,&quot;caller_number_source&quot;:&quot;internal&quot;,&quot;caller_billing_reference_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;charge&quot;:&quot;\u003cstring\u003e&quot;,&quot;client_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;date_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;direction&quot;:&quot;\u003cstring\u003e&quot;,&quot;duration&quot;:&quot;\u003cinteger\u003e&quot;,&quot;forwarded_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;extension_type&quot;:&quot;sharedLineGroup&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;forwarded_to&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;has_recording&quot;:&quot;\u003cboolean\u003e&quot;,&quot;has_voicemail&quot;:&quot;\u003cboolean\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;outgoing_by&quot;:{&quot;extension_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;},&quot;path&quot;:&quot;\u003cstring\u003e&quot;,&quot;rate&quot;:&quot;\u003cstring\u003e&quot;,&quot;recording_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;result&quot;:&quot;\u003cstring\u003e&quot;,&quot;site&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;hold_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;waiting_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;department&quot;:&quot;\u003cstring\u003e&quot;,&quot;cost_center&quot;:&quot;\u003cstring\u003e&quot;}],&quot;from&quot;:&quot;\u003cstring\u003e&quot;,&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;page_size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;to&quot;:&quot;\u003cstring\u003e&quot;,&quot;total_records&quot;:&quot;\u003cinteger\u003e&quot;}