GET /api/v2/call
Provides a paginated list of calls matching the specified filter parameters in reverse-chronological order by call start time (i.e. recent calls first)
Note: This API will only include calls that have already concluded.
When no target is specified, company-level API keys and company admins list all of the company's calls, and other user-level API keys list the authenticated user's own calls.
Requires scope: calls:list
Rate limit: 1200 per minute.
Servers
- https://dialpad.com/
- https://sandbox.dialpad.com/
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
started_after |
Integer | No |
Only includes calls that started more recently than the specified timestamp. (UTC ms-since-epoch timestamp) |
include_anonymized |
Boolean | No |
If set to true, includes call records that have been anonymized (e.g., calls associated with deleted users). Defaults to false. Default value: false |
started_before |
Integer | No |
Only includes calls that started prior to the specified timestamp. (UTC ms-since-epoch timestamp) |
cursor |
String | No |
A token used to return the next page of a previous request. Use the cursor provided in the previous response. |
target_id |
Integer | No |
The ID of a target to filter against. Defaults to the whole company for company-level API keys and company admins, and to the authenticated user for all other user-level API keys. |
target_type |
String | No |
The target type associated with the target ID. Must be provided whenever target_id is provided. Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.