Documentation
Sign inGet started

bird voice stats by-country

Usage

Code example
bird voice stats by-country [flags]

Description

Voice stats grouped by destination country, ranked by sort (default total_calls) and capped at limit (default 50, max 200); the response's total tells a capped ranking from a complete one. Countries sharing a calling code remain separate rows, so a +1 call to Canada appears under Canada. Calls whose destination cannot be determined collect under a null country. For failure causes use bird voice stats by-response-code.

Procedure

Step 4 of 8 of "Watch voice calls and find out why one was refused". Previous: bird voice stats summary. Next: bird voice stats by-response-code.

Examples

Code example
bird voice stats by-country

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 the sort metric descending. The response's total reports how many rows existed before this cap.
--response-schemaPrint the fields this command returns, then exit
--sortWhich metric ranks the breakdown rows, always descending. Defaults to total_calls. Possible values: total_calls, answered_calls, asr, acd_ms.
--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-response-codeGet Voice statistics by response code
bird voice stats dailyGet daily Voice statistics
bird voice stats hourlyGet hourly Voice statistics
bird voice stats summaryGet aggregate Voice statistics