GET
/
v1
/
calls

Authorizations

Authorization
string
headerrequired

Query Parameters

phoneNumberId
string
required

The unique identifier of the OpenPhone number associated with the call.

userId
string

The unique identifier of the OpenPhone user who either placed or received the call. Defaults to the workspace owner.

participants
string[]
required

The phone numbers of participants involved in the call conversation, excluding your OpenPhone number. Each number should contain the country code and conform to the E.164 format. Currently limited to one-to-one (1:1) conversations only.

since
string
deprecated

DEPRECATED, use "createdAfter" or "createdBefore" instead. "since" incorrectly behaves as "createdBefore" and will be removed in an upcoming release.

createdAfter
string

Filter results to only include calls created after the specified date and time, in ISO 8601 format.

createdBefore
string

Filter results to only include calls created before the specified date and time, in ISO 8601 format.

maxResults
integer
default: 10required

Maximum number of results to return per page.

pageToken
string

Response

200 - application/json
data
object[]
required

Array of items

totalItems
integer
required

Total number of items available.

nextPageToken
string | null
required