Skip to main content
GET
Get phone average handle time breakdown
Takes the same filters as Phone handle time, plus group_by: team (the team the agent answered from), agent, day, week (starting Monday), or month, in timezone.

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
group_by
enum<string>
required

team = the queue the agent answered from. day, week (from Monday) and month are calendar periods in timezone.

Available options:
team,
agent,
day,
week,
month

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.

grouping
object
required