Zoom Phone Call History API — Filter by Phone Number / Callee Number

Phone
1

Hi Zoom Developer Community,

We are building an ATS (Applicant Tracking System) integration with Zoom Phone. Our use case is to fetch historical call logs between a recruiter and a specific candidate (identified by their mobile number).

What we are currently using:

GET /phone/users/{userId}/call_history
Parameters we pass:

from: 2025-04-15
to: 2025-05-15
page_size: 100
type: all
The problem:

This API returns the entire call history for the Zoom user across all contacts for the given date range. We then have to loop through every page and filter records locally by matching callee_number or caller_number against the candidate’s phone number.

For recruiters with high call volumes (500+ calls/month), this means fetching all pages just to find 3–4 calls to a specific candidate — which is inefficient.

Our question:

Is there any Zoom Phone API that supports filtering call history by a specific phone number (callee or caller)?
For example, something like:

GET /phone/users/{userId}/call_history?phone_number=+12015550173
Or is there a search API for Zoom Phone call logs that accepts a phone number as a filter?
If not available today, is this on the roadmap?
Any guidance or alternative approach would be greatly appreciated.

Thank you.

2

Hi, we ran into the same issue with high-volume users. Unfortunately there’s no direct phone_number filter parameter in the current API — it’s a known limitation.

What worked for us as a workaround: instead of fetching all pages, we used webhooks to capture call logs in real-time and stored them in our own database with phone number indexing. That way historical lookups become a simple local query.

Would definitely support a native phone_number filter param being added — would save a lot of unnecessary API calls. +1 for the roadmap request!