# `bird voice stats by-country`

## Usage

```bash
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 are separate rows (a +1 call to Canada is not a US row), and calls whose destination could not be determined collect under a null `country`. This is where traffic and quality by destination live; for failure causes use 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

```bash
bird voice stats by-country
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--direction`       | When set, limits the statistics to call legs in this direction. Omit to include all legs. Possible values: inbound, outbound.                                                                                                                                                                                                                |
| `--from`            | Start 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-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                             |
| `--sort`            | Which metric ranks the breakdown rows, always descending. Defaults to total_calls. Possible values: total_calls, answered_calls, asr, acd_ms.                                                                                                                                                                                                |
| `--timezone`        | IANA timezone identifier (for example Asia/Kathmandu) to report in; defaults to UTC. Day and hour boundaries and the default window when from and to are omitted both follow it, so a calendar-day from or to names a local day. A from or to carrying its own UTC offset is rejected while this is set: pass a calendar day or a Z instant. |
| `--to`              | End 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.                                                                                                                                         |

## Related

| Name                                                                                    | Description                   |
| --------------------------------------------------------------------------------------- | ----------------------------- |
| [`bird voice stats by-response-code`](/docs/cli/reference/voice-stats-by-response-code) | Voice stats by response code  |
| [`bird voice stats daily`](/docs/cli/reference/voice-stats-daily)                       | Daily voice statistics        |
| [`bird voice stats hourly`](/docs/cli/reference/voice-stats-hourly)                     | Hourly voice statistics       |
| [`bird voice stats summary`](/docs/cli/reference/voice-stats-summary)                   | Aggregate voice stats summary |