v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Calls

Search for Calls

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

Use the Search for Calls endpoint to find calls that your team has made or received using <a href="https://knowledge.apollo.io/hc/en-us/articles/4409140527757-Dialer-Overview" target="_blank">the dialer</a> on Apollo. This endpoint requires a master API key. If you call the endpoint without a master key, you receive a 403 response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master API key.

get/phone_calls/search

Query parameters

date_range[max]string date

Set the upper bound of the date range you want to search. Use this parameter in combination with the date_range[min] parameter. This date should fall after the date_range[min] date. The date should be formatted as YYYY-MM-DD. Example: 2025-06-12

date_range[min]string date

Set the lower bound of the date range you want to search. Use this parameter in combination with the date_range[max] parameter. This date should fall before the date_range[max] date. The date should be formatted as YYYY-MM-DD. Example: 2025-04-01

duration[max]integer

Set the upper bound for the call duration you want to search. The duration should be seconds, not minutes or hours. Use this parameter in combination with the duration[min] parameter. This number should be larger than duration[min]. Example: 180

duration[min]integer

Set the lower bound for the call duration you want to search. The duration should be seconds, not minutes or hours. Use this parameter in combination with the duration[max] parameter. This number should be smallerr than duration[min]. Example: 30

inboundstring

Search for calls based on whether they were incoming (the prospect called your team) or outgoing (your team called the prospect).

user_ids[]string[]

Find calls that included specific users in your team's Apollo account. You can add multiple users. Use the <a href="https://docs.apollo.io/reference/get-a-list-of-users" target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all of the users within your Apollo account. Example: 67e33d527de088000daa60c4

contact_label_ids[]string[]

Find calls that included specific contacts. You can add multiple contacts. In Apollo terminology, a contact is a person that your team has explicitly added to your database. Use the <a href="https://docs.apollo.io/reference/get-a-list-of-users" target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all of the users within your Apollo account. Example: 67e33d527de088000daa60c4 6708415f59d9c70001b2f852

phone_call_purpose_ids[]string[]

Filter calls based on their purpose. Call purposes are unique to your team's Apollo account. When you use the Purpose search filter for calls in the Apollo product, you can find the corresponding call purpose ID in the URL. Example: 6095a710bd01d100a506d4cf

phone_call_outcome_ids[]string[]

Filter calls based on their outcome. Call outcomes are unique to your team's Apollo account. When you use the Disposition search filter for calls in the Apollo product, you can find the corresponding call outcome ID in the URL. Example: 6095a710bd01d100a506d4c5

q_keywordsstring

Add keywords to narrow the search of the calls in your team's Apollo account. Example: marketing conference attendees

pagestring

The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4

per_pagestring

The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10

v1

Search for Calls

Query parameters

Response