Documentation
Sign inGet started

bird voice stats by-response-code

Usage

Code example
bird voice stats by-response-code [flags]

Description

Call counts grouped by final SIP response code, the "how are my calls ending" view. Successes are rows too (200 is one), so the rows sum to the whole period rather than to failures, and each row's share is against period_total_calls. Calls that got no final response collect under a null code. Capped at limit (default 50, max 200). This reports SIP outcomes; a call Bird itself refused carries no SIP code that distinguishes the cause, so read rejection_reason on the call record with bird voice get.

Procedure

Step 5 of 8 of "Watch voice calls and find out why one was refused". Previous: bird voice stats by-country. Next: bird voice trunks get.

Examples

Code example
bird voice stats by-response-code

Options

NameDescription
--directionWhen set, limits the statistics to call legs in this direction. Omit to include all legs. Possible values: inbound, outbound.
--fromStart date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted). Defaults to 30 days before to when omitted.
--limit <n>Maximum number of rows to return, ranked by call count descending. The response's total reports how many rows existed before this cap.
--response-schemaPrint the fields this command returns, then exit
--timezoneIANA timezone identifier used to group statistics, for example Asia/Kathmandu. The default is UTC. Day and hour boundaries, including the default window when from and to are omitted, follow this timezone. When this parameter is set, pass from and to as calendar days or Z instants instead of timestamps with explicit UTC offsets.
--toEnd date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted). Defaults to today in that timezone when omitted. Window may not exceed 365 days.
NameDescription
bird voice stats by-countryGet Voice statistics by country
bird voice stats dailyGet daily Voice statistics
bird voice stats hourlyGet hourly Voice statistics
bird voice stats summaryGet aggregate Voice statistics