Zoom Phone call history and call logs API

See also

Sources

1. 1
   GET /phone/call_history is the Zoom Phone operation 'Get account's call history', which returns the account's new edition of call logs.

   Zoom Phone API reference · Call Logs tag > Get account's call history · Checked 2026-10-14
2. 2
   Get account's call history carries the HEAVY rate-limit label.

   Zoom Phone API reference · Call Logs tag > Get account's call history > Rate Limit Label · Checked 2026-10-14
3. 3
   Get account's call history requires a Business or Enterprise account and a Zoom Phone license, and the caller must be the account owner or hold a Zoom Phone management role.

   Zoom Phone API reference · Call Logs tag > Get account's call history > Prerequisites · Checked 2026-10-14
4. 4
   Get account's call history accepts classic scopes phone:read:admin or phone_call_log:read:admin and the granular scope phone:read:list_call_logs:admin.

   Zoom Phone API reference · Call Logs tag > Get account's call history > Scopes · Checked 2026-10-14
5. 5
   The call history and call element operations also exist as account-scoped paths under /v2/accounts/{accountId}/phone/.

   Call History API migration · Added > Endpoints · Checked 2026-10-14
6. 6
   The August 2026 changelog adds ai_call_summary_id to user call history and Get call history responses, and call_element_ids to the phone.ai_call_summary_changed webhook.

   Added WhatsApp Messaging and Call Logs APIs · Enhancements > ai_call_summary_id; Webhooks · Checked 2026-10-14
7. 7
   The migration guide states that the call_log array (account call history) and the call_path array (call history) are deprecated in November 2026, replaced by call_history and call_elements.

   Migrate Zoom Phone Call Log APIs to Call History · Recent changes to call history endpoints > Get account's call history; Get call history · Checked 2026-10-14
8. 8
   GET /phone/call_element/{callElementId} is 'Get call element', granular scope phone:read:call_log:admin, rate-limit label LIGHT.

   Zoom Phone API reference · Call Logs tag > Get call element · Checked 2026-10-14
9. 9
   The June 2026 changelog adds a call_ids request parameter to GET /v2/phone/call_history and GET /v2/accounts/{accountId}/phone/call_history.

   New call ID filtering for call history APIs · Enhancements · Checked 2026-10-14
10. 10
    As of 2026-10-14 the API reference still lists GET /phone/call_logs (Get account's call logs) and Get call log details, both marked deprecated.

    Zoom Phone API reference · Call Logs tag > Get account's call logs (deprecated); Get call log details (deprecated) · Checked 2026-10-14
11. 11
    The 2025-11-13 changelog renamed the 'Get call path' operation to 'Get call history'.

    Call History API migration · Call History API migration (rename note) · Checked 2026-10-14
12. 12
    The October 2025 changelog deprecates the client_code response field in GET /v2/phone/call_history and limits the PATCH client_code operation to adding a user client code.

    Upcoming deprecations of Call Log APIs and Zoom Phone client_code fields · client_code field changes · Checked 2026-10-14
13. 13
    The August 2026 changelog adds PATCH /v2/phone/call_history/{callElementId}/client_code and its account-scoped form, keyed by call element ID.

    Added WhatsApp Messaging and Call Logs APIs · Added > New Call Logs APIs · Checked 2026-10-14
14. 14
    The December 2023 changelog announced that /phone/call_logs and /phone/call_logs/{callLogId} would be sunset on June 18, 2025 in favour of /phone/call_history endpoints.

    Zoom Phone call log deprecation · Zoom Phone call log deprecation (entry body) · Checked 2026-10-14
15. 15
    DELETE /phone/users/{userId}/call_history/{callElementId} deletes a user's call history entry and returns 204 on success.

    Zoom Phone API reference · Call Logs tag > Delete a user's call history · Checked 2026-10-14
16. 16
    The API reference marks GET /phone/call_history_detail/{callHistoryId} (Get call history detail) as deprecated.

    Zoom Phone API reference · Call Logs tag > Get call history detail (deprecated) · Checked 2026-10-14
17. 17
    direction is inbound or outbound, connect_type is internal or external, and call_type is general or emergency.

    Zoom Phone API reference · Call Logs tag > Get account's call history > call_history > direction, connect_type, call_type · Checked 2026-10-14
18. 18
    duration (seconds) and recording_status (recorded or non_recorded) appear on Get account's call history items but not in the single-record call history or call element responses.

    Zoom Phone API reference · Call Logs tag > Get account's call history > call_history > duration, recording_status · Checked 2026-10-14
19. 19
    The 2025-11-13 changelog adds call_element_id to recording and voicemail API responses and to the recording_completed and voicemail_received webhook payloads.

    Call History API migration · Enhancements > call_element_id · Checked 2026-10-14
20. 20
    The 2025-11-13 changelog adds webhooks phone.call_element_deleted, phone.callee_call_element_completed and phone.caller_call_element_completed.

    Call History API migration · Added > Webhooks · Checked 2026-10-14
21. 21
    The 2025-11-10 changelog adds a call_elements field to the user call history and sync user call history responses.

    New and enhanced Call Logs APIs · Enhancements · Checked 2026-10-14
22. 22
    The 'event' enum also includes incoming, outgoing, forward, ring_to_member, overflow, timeout, call_me_on, shared_line_incoming and outgoing_to_zoom_contact_center.

    Zoom Phone API reference · Call Logs tag > Get call history / Get call element > Responses > event · Checked 2026-10-14
23. 23
    The 'event' enum includes supervisor and feature values barge, monitor, whisper, listen, takeover, conference_barge, park, park_pick_up, merge and shared.

    Zoom Phone API reference · Call Logs tag > Get call history / Get call element > Responses > event · Checked 2026-10-14
24. 24
    The call element 'event' enum includes the transfer values direct_transfer, warm_transfer and transfer_from_zoom_contact_center.

    Zoom Phone API reference · Call Logs tag > Get call history / Get call element > Responses > event · Checked 2026-10-14
25. 25
    caller_ext_type, callee_ext_type and operator_ext_type take the values user, call_queue, auto_receptionist, common_area, zoom_room, cisco_room, shared_line_group, group_call_pickup and external_contact.

    Zoom Phone API reference · Call Logs tag > Get call element > Responses > callee_ext_type / operator_ext_type · Checked 2026-10-14
26. 26
    In 2024 developers reported that /phone/call_history was not a drop-in replacement for /phone/call_logs: JSON differed and fields such as charge, rate, path, user_id and caller_user_id were missing.field report

    Phone call_logs and call_history API compatibility · Posts 2024-08-15 (pete_h), 2024-09-18 (Ciaran), 2024-10-08 (Francisco Alejandro), 2024-10-11 (Gianni) · Checked 2026-10-14
27. 27
    Developers reported that from about 2024-11-15 warm transfers appeared in the call history API as a single inbound call with no visible transfer.field report

    Zoom Phone Warm Transfer Logs Someone Got Worse · Original post, paul.woltman, 2025-02-21 · Checked 2026-10-14
28. 28
    Developers reported warm_transfer events appearing in call_path from 2025-05-19 but still with no field linking the transferred leg to the original call, and the issue was open as of February 2026.field report

    Zoom Phone Warm Transfer Logs Someone Got Worse · Posts 2025-05-20 (paul.woltman), 2026-01-22 (Stevo), 2026-02-12 (Elisa) · Checked 2026-10-14
29. 29
    A field workaround for linking transfers is to store call history and correlate entries on call ID, start_time, direction, connect_type, hold_time greater than 0 and matching callee extension and end_time.field report

    Zoom Phone Warm Transfer Logs Someone Got Worse · Post 2026-01-20, paul.woltman · Checked 2026-10-14
30. 30
    GET /phone/call_history/{callHistoryUuid} is 'Get call history', granular scope phone:read:call_log:admin, rate-limit label LIGHT.

    Zoom Phone API reference · Call Logs tag > Get call history · Checked 2026-10-14
31. 31
    The August 2026 changelog adds handler_ext_id, handler_ext_type, handler_ext_number and handler_name to the Get call history (by callHistoryUuid) responses.

    Added WhatsApp Messaging and Call Logs APIs · Enhancements > handler fields · Checked 2026-10-14
32. 32
    The 2025-11-13 changelog lists phone.callee_call_history_completed, phone.caller_call_history_completed and phone.call_history_deleted as deprecated, alongside the call_log webhooks.

    Call History API migration · Deprecated > Webhooks · Checked 2026-10-14
33. 33
    hold_time and waiting_time are integers expressed in seconds.

    Zoom Phone API reference · Call Logs tag > Get call element > Responses > hold_time, waiting_time · Checked 2026-10-14
34. 34
    The migration guide maps v2 GET /phone/call_history_detail/{callHistoryId} to v3 GET /phone/call_element/{call_element_id}, with no legacy v1 equivalent.

    Migrate Zoom Phone Call Log APIs to Call History · API version mapping table · Checked 2026-10-14
35. 35
    In v3 the record identifier id becomes call_history_uuid, the call_logs object becomes call_history, and call_elements entries carry call_id and call_element_id.

    Migrate Zoom Phone Call Log APIs to Call History · Recent changes to call history endpoints; How to migrate steps 3-4 · Checked 2026-10-14
36. 36
    The migration guide maps legacy v1 GET /phone/call_logs to GET /phone/call_history in both v2 and v3.

    Migrate Zoom Phone Call Log APIs to Call History · API version mapping table · Checked 2026-10-14
37. 37
    The migration guide maps v1 GET /phone/call_logs/{callLogId} to v2 GET /phone/call_history/{callLogId} and v3 GET /phone/call_history/{call_history_uuid}.

    Migrate Zoom Phone Call Log APIs to Call History · API version mapping table · Checked 2026-10-14
38. 38
    The May 2025 changelog announced that six Call Log APIs (add client code, delete, account list, details, user list, sync) and the call_log webhooks would be deprecated on November 30, 2025.

    Upcoming deprecation of Call Log APIs · Upcoming deprecation of Call Log APIs (deprecated APIs list) · Checked 2026-10-14
39. 39
    No documented call history or call element field explicitly links a transferred segment back to the originating call, so transfer chains must be reconstructed by correlating elements.inferred

    Zoom Phone API reference · Call Logs tag > Get call history / Get call element > Responses (whole schema) · Checked 2026-10-14
40. 40
    IDs from the deprecated call log endpoints and webhooks are not compatible with the new Call History APIs and webhooks.

    Understand Zoom Phone call history · Understand Zoom Phone call history (intro note) · Checked 2026-10-14
41. 41
    The next_page_token returned by the call history list endpoints expires after 15 minutes.

    Zoom Phone API reference · Call Logs tag > Get account's call history and Get user's call history > Responses > next_page_token · Checked 2026-10-14
42. 42
    The admin portal Call Path view lists, per step, the call ID, start and end times, event, waiting time, actions, result, talking time and device, including auto receptionist routing and transfers.

    Viewing Zoom Phone call history logs (New View) · Viewing the call path · Checked 2026-10-14
43. 43
    In the admin portal Calls log, the Event filter offers 'Transfer' for direct or warm transfers between users and 'System Transfer' for forwarding, ringing members and overflow.

    Viewing Zoom Phone call history logs (New View) · Filters > Event · Checked 2026-10-14
44. 44
    In Zoom's worked example, a call through an auto receptionist (press_key 1) to a call queue shows a call_queue entry, then user entries with event ring_to_member for each alerted member.

    Understand Zoom Phone call history · Analyze call logs > 3. Analyze the results · Checked 2026-10-14
45. 45
    In the worked example, queue-member entries name the call queue in the operator_ext_* and operator_name fields.

    Understand Zoom Phone call history · Analyze call logs > 2. Query Get call path (example response) · Checked 2026-10-14
46. 46
    On Business+ plans Zoom Phone APIs are limited to 40 req/s for Light, 20 req/s for Medium and 10 req/s for Heavy, with Heavy sharing a 30,000 requests/day cap with resource-intensive APIs.

    Rate limits · Rate limits by account type > Zoom Phone APIs · Checked 2026-10-14
47. 47
    call_result (list) and result (element) share 20 values including answered, voicemail, abandoned, overflowed, ring_timeout, no_answer, busy, rejected, call_failed and system_blocked.

    Zoom Phone API reference · Call Logs tag > Get account's call history > call_history > call_result; Get call element > result · Checked 2026-10-14
48. 48
    The result_reason field takes the values answered_by_other, pickup_by_other and call_out_by_other.

    Zoom Phone API reference · Call Logs tag > Get call history / Get call element > Responses > result_reason · Checked 2026-10-14
49. 49
    Call detail records for calls on Zoom-assigned numbers, excluding BYOC numbers, are retained for at least two years and cannot be deleted until two years after the call date.

    Managing retention policy for Zoom Phone · Note on minimum retention for Zoom-assigned numbers · Checked 2026-10-14
50. 50
    Zoom Phone retention covers call logs among other data types; with auto-delete enabled the default is 180 days, configurable from 1 to 4000 days, and with it disabled retention is unlimited.

    Managing retention policy for Zoom Phone · Retention settings (data types and durations) · Checked 2026-10-14
51. 51
    segment and node are integers starting at 0 that order the events within a call.

    Zoom Phone API reference · Call Logs tag > Get call history > call_elements / call_path > segment, node · Checked 2026-10-14
52. 52
    Zoom's guide identifies simultaneous ringing of queue members by identical start_time values on the member entries.

    Understand Zoom Phone call history · Analyze call logs > 3. Analyze the results · Checked 2026-10-14
53. 53
    GET /phone/users/{userId}/call_history/sync (Sync user's call history) has rate-limit label MEDIUM and returns a sync_token that marks where the next retrieval begins.

    Zoom Phone API reference · Call Logs tag > Sync user's call history > Responses > sync_token · Checked 2026-10-14
54. 54
    The top-level call history record may show only a small fraction of how a call routes; the per-step routing is in the call path returned for that record.

    Understand Zoom Phone call history · Get the call path · Checked 2026-10-14
55. 55
    GET /phone/users/{userId}/call_history (Get user's call history) has rate-limit label MEDIUM, accepts granular scope phone:read:list_call_logs or its :admin form, and lets user-level apps pass 'me' as userId.

    Zoom Phone API reference · Call Logs tag > Get user's call history · Checked 2026-10-14
56. 56
    The 2025-11-13 changelog states the legacy Call Logs APIs (v1) will be fully deprecated in May 2026, describing this as an extension of the earlier date.disputed

    Call History API migration · Call History API migration (intro paragraph) · Checked 2026-10-14
57. 57
    The migration guide states the legacy Call Logs API (v1) will be fully deprecated in April 2026.disputed

    Migrate Zoom Phone Call Log APIs to Call History · Migrate Zoom Phone Call Log APIs to Call History (intro) · Checked 2026-10-14
58. 58
    The understanding-call-history guide states the deprecated call log APIs and webhooks are no longer supported after November 30, 2025.disputed

    Understand Zoom Phone call history · Understand Zoom Phone call history (intro note) · Checked 2026-10-14
59. 59
    The understanding guide says passing a webhook-provided ID to GET /phone/call_history/{id} returns 404 and that the call history detail endpoint is for webhook IDs only.

    Understand Zoom Phone call history · Get call history detail with webhook payload ID · Checked 2026-10-14
60. 60
    The October 2025 changelog maps phone.callee_call_log_completed and phone.caller_call_log_completed to phone.callee_call_history_completed and phone.caller_call_history_completed, and phone.call_log_deleted to phone.call_history_deleted.

    Upcoming deprecations of Call Log APIs and Zoom Phone client_code fields · Deprecated webhooks list · Checked 2026-10-14

Documents

Cite this page

WarmTransfer. (2026, October 14). Zoom Phone call history and call logs API. WarmTransfer. https://warmtransfer.net/knowledge/zoom-phone-call-history-api

@misc{warmtransfer-zoom-phone-call-history-api,
  title  = {Zoom Phone call history and call logs API},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/zoom-phone-call-history-api},
  note   = {Verified 2026-10-14}
}