Call -- List

get

https://dialpad.com/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, user-level API keys list the authenticated user's own calls, and company-level API keys list all of the company's calls.

Requires scope: calls:list

Rate limit: 1200 per minute.

Query Params

cursor

string

A token used to return the next page of a previous request. Use the cursor provided in the previous response.

include_anonymized

boolean

Defaults to false

If set to true, includes call records that have been anonymized
(e.g., calls associated with deleted users). Defaults to false.

started_after

int64

Only includes calls that started more recently than the specified timestamp.
(UTC ms-since-epoch timestamp)

started_before

int64

Only includes calls that started prior to the specified timestamp.
(UTC ms-since-epoch timestamp)

target_id

int64

The ID of a target to filter against. Defaults to the authenticated user for user-level API keys, and to the whole company for company-level API keys.

target_type

string

enum

The target type associated with the target ID. Must be provided whenever target_id is provided.

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A successful response