Parallel dialer analytics report

GET

/voice/dialer/stats

• Production
• QA

Return aggregated dialer metrics for the caller’s org.

Org scoping is enforced server-side: the voice service accepts a user_email filter but the org is always pinned to the API key.

Authorizations

• BearerAuth

Parameters

Query Parameters

session_id

Any of:

string

string

null

null

Filter to a single session.

user_email

Any of:

string

string

null

null

Filter to one SDR’s calls.

date_from

Any of:

string

string

null

null

Start date “YYYY-MM-DD”.

date_to

Any of:

string

string

null

null

End date “YYYY-MM-DD”.

aggregation

“DAILY” for per-day rows, “TOTAL” for one summary row.

string

default: DAILY

“DAILY” for per-day rows, “TOTAL” for one summary row.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

Top-level wrapper for dialer analytics.

Field names follow the voice ParallelDialerReport shape so the structured response is meaningful both to a Developer API caller and to an MCP agent rendering it inline.

object

filters

Echo of the filters the voice service ran the report with.

Useful for clients that need to confirm which slice they got back, especially when the request omits date_from / date_to and the server applies defaults.

object

aggregation

Any of:

string

string

null

null

date_from

Any of:

unknown

null

null

date_to

Any of:

unknown

null

null

org_id

Any of:

string

string

null

null

session_id

Any of:

string

string

null

null

user_email

Any of:

string

string

null

null

metrics

Array<object>

One aggregated row in the analytics report.

Schema mirrors ParallelDialerMetrics. The disposition breakdown is a passthrough dict so that voice-side disposition additions do not require a coordinated DTO bump here.

object

avg_call_duration_minutes

number

avg_calls_per_session

number

connection_rate

number

date

Any of:

string

string

null

null

dispositions

Any of:

object

object

key

additional properties

any

null

null

list_title

Any of:

string

string

null

null

org_id

Any of:

string

string

null

null

peak_calling_hour

Any of:

integer

integer

null

null

redial_count

integer

redial_success_rate

Any of:

number

number

null

null

sdr_name

Any of:

string

string

null

null

success_rate

number

talk_time_minutes

number

total_callbacks

integer

total_connections

integer

total_dials

integer

total_voicemails

integer

unique_sessions

integer

voicemail_rate

number

summary

Any of:

DialerReportMetric

One aggregated row in the analytics report.

Schema mirrors ParallelDialerMetrics. The disposition breakdown is a passthrough dict so that voice-side disposition additions do not require a coordinated DTO bump here.

object

avg_call_duration_minutes

number

avg_calls_per_session

number

connection_rate

number

date

Any of:

string

string

null

null

dispositions

Any of:

object

object

key

additional properties

any

null

null

list_title

Any of:

string

string

null

null

org_id

Any of:

string

string

null

null

peak_calling_hour

Any of:

integer

integer

null

null

redial_count

integer

redial_success_rate

Any of:

number

number

null

null

sdr_name

Any of:

string

string

null

null

success_rate

number

talk_time_minutes

number

total_callbacks

integer

total_connections

integer

total_dials

integer

total_voicemails

integer

unique_sessions

integer

voicemail_rate

number

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string