# `bird voice stats by-response-code`

## Usage

```bash
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 via voice_get instead.

## 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

```bash
bird voice stats by-response-code
```

## 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 call count descending. The response's total reports how many rows existed before this cap.                                                                                                                                                                                                       |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                             |
| `--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-country`](/docs/cli/reference/voice-stats-by-country) | Voice stats by country        |
| [`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 |