Skip to main content
GET
Get phone average handle time
from and to select handles by when the agent answered. timezone is an IANA name, default UTC. Filter with team_id, policy_id, user_id, or direction (inbound, outbound). aht_seconds is (talk_seconds + hold_seconds + after_call_work_seconds) / handles. Only finished handles count: the agent has left the call and their after-call work has ended. A call two agents handled counts once for each. over_target_rate is over_target / graded, where graded handles had an AHT target when the agent answered. target_seconds is the target when every handle in the range had the same one, otherwise null. See Average handle time.

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

Response

Default Response

handles
integer
required

Finished handles: an agent answered, left the call, and their after-call work ended. A call two agents handled counts once for each.

Required range: -9007199254740991 <= x <= 9007199254740991
talk_seconds
number
required

Total talk time: on the call, holds excluded.

hold_seconds
number
required

Total time the agents kept callers on hold.

after_call_work_seconds
number
required

Total after-call work: from leaving the call to the end of wrap-up.

avg_talk_seconds
number | null
required
avg_hold_seconds
number | null
required
avg_after_call_work_seconds
number | null
required
aht_seconds
number | null
required

Average handle time: (talk + hold + after-call work) ÷ handles.

aht_seconds_p90
number | null
required
graded
integer
required

Handles that had an AHT target when the agent answered.

Required range: -9007199254740991 <= x <= 9007199254740991
over_target
integer
required

Graded handles that took longer than their target.

Required range: -9007199254740991 <= x <= 9007199254740991
over_target_rate
number
required

over_target / graded, 0–1.

target_seconds
integer | null
required

The AHT target when every handle in range had the same one.

Required range: -9007199254740991 <= x <= 9007199254740991