Skip to main content
GET
List phone call handles
Returns one row per stint of an agent on a call, oldest answer first, with the same filters as Phone handle time. An agent who leaves a call and comes back to it (a conference guest invited again, a queue ringing them again) has a row for each stint; the handle time reports add those up and count the agent once for that call. Until a row is finished, some parts are still running:
  • talk_seconds is null while the agent is on the call, and final once they leave.
  • after_call_work_seconds and handle_seconds are null until the agent’s after-call work ends.
  • hold_seconds is never null: it is the agent’s hold time so far.
Page with limit (up to 500, default 100) and pass next_cursor back as cursor.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

timezone
string
default:UTC

IANA timezone for day and hour buckets.

team_id
string
Maximum string length: 36
policy_id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
user_id
integer

Only this agent’s handles.

Required range: x <= 9007199254740991
direction
enum<string>
Available options:
inbound,
outbound
limit
integer
default:100
Required range: 1 <= x <= 500
cursor
string

The next_cursor of the previous page.

Maximum string length: 200

Response

Default Response

data
object[]
required
next_cursor
string | null
required

Pass as cursor to fetch the next page; null on the last page.