# `bird voice stats by-number-country` ## Usage ```bash bird voice stats by-number-country [flags] ``` ## Description Groups completed call legs by own number country over up to 365 days. The country belongs to the own number: the source on outbound calls and the destination on inbound calls. Unknown countries, including historical outbound calls without a recorded source country, share a null country row. Rows rank by the requested metric, descending. ## Examples ```bash bird voice stats by-number-country ``` ## Options | Name | Description | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--destination` | When set, limits the statistics to calls to this destination country, as an ISO 3166-1 alpha-2 code. This is the drill-down from a row of the destination breakdown, and it matches the same country that breakdown reports for a call. | | `--direction` | When set, limits the statistics to call legs in this direction. Omit to include all legs. Possible values: inbound, outbound. | | `--from` | Inclusive start of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone (a calendar day names a local day and an instant is rounded down to the local hour), or in UTC when timezone is omitted. A numeric UTC offset (for example +05:45) is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as to. Defaults to 30 days before to for day windows, or 168 hours (7 days) before to for hour windows, when omitted. | | `--limit ` | Maximum number of rows to return, ranked by the sort metric descending. The response's total reports how many rows existed before this cap. | | `--own-number` | When set, limits the statistics to calls on this number of yours, in E.164 form. It matches your own end of the call, which is the caller on an outbound leg and the recipient on an inbound one. It is named apart from the call log's number because that one matches either party, where this one is always your end. A number that has no standard form matches exactly as the network presented it, so an unusual one is still searchable. A value that matches no call gives an empty result rather than an error, as any unmatched filter does. To narrow by the party you called instead, use destination. | | `--response-schema` | Print the fields this command returns, then exit | | `--short-call-threshold-ms ` | Duration in milliseconds below which an answered call counts toward short\_calls. The default of 30 seconds is a convention rather than a property of the network, so set it to whatever your own definition of a call too short to have been useful is. Every response echoes the value it used, so a stored figure can always be read against the definition that produced it. | | `--sort` | Which metric ranks the breakdown rows, always descending. Defaults to total\_calls. Possible values: total\_calls, answered\_calls, asr, acd\_ms. | | `--status …` | When set, limits the statistics to calls with one of these statuses, comma-separated. Four of the vocabulary's values match nothing here, for three different reasons: these statistics cover ended calls only, so ringing and in\_progress are outside their scope; busy and canceled are not emitted yet and arrive as failed today; and no call is stored as other, which the outcome split uses for a status it does not name. The five that do match are answered, no\_answer, failed, rejected and unknown. Possible values: answered, no\_answer, busy, canceled, failed, rejected, unknown, ringing, in\_progress. | | `--timezone` | IANA 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. | | `--to` | Inclusive end of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone (a calendar day names a local day and an instant is rounded down to the local hour), or in UTC when timezone is omitted. A numeric UTC offset is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as from. Defaults to today for day windows, or the current hour for hour windows, in that timezone, when omitted. Day windows may not exceed 365 days; hour windows may not exceed 8760 hours (365 days). | | `--trunk-id` | When set, limits the statistics to calls carried by this SIP trunk. This is the drill-down from a row of the trunk breakdown. Calls that used no trunk, such as Verify voice calls, match no value here and are excluded whenever it is set. | ## Related | Name | Description | | --------------------------------------------------------------------------------------- | ------------------------------------- | | [`bird voice stats by-country`](/docs/cli/reference/voice-stats-by-country) | Get Voice statistics by country | | [`bird voice stats by-hour-of-day`](/docs/cli/reference/voice-stats-by-hour-of-day) | Get Voice statistics by hour of day | | [`bird voice stats by-number`](/docs/cli/reference/voice-stats-by-number) | Get Voice statistics by own number | | [`bird voice stats by-response-code`](/docs/cli/reference/voice-stats-by-response-code) | Get Voice statistics by response code | | [`bird voice stats by-trunk`](/docs/cli/reference/voice-stats-by-trunk) | Get Voice statistics by SIP trunk | | [`bird voice stats by-weekday`](/docs/cli/reference/voice-stats-by-weekday) | Get Voice statistics by weekday | | [`bird voice stats daily`](/docs/cli/reference/voice-stats-daily) | Get daily Voice statistics | | [`bird voice stats hourly`](/docs/cli/reference/voice-stats-hourly) | Get hourly Voice statistics | | [`bird voice stats summary`](/docs/cli/reference/voice-stats-summary) | Get aggregate Voice statistics | ## Related resources - [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer) - [Build your first integration](/learn/paths/integration) (course) - [Send your first email](/docs/get-started/send-your-first-email) (docs) [Get an implementation brief](/learn/workspace?topic=api-basics)