# `bird voice list`

## Usage

```bash
bird voice list [flags]
```

## Description

List the workspace's calls, newest first. Filter to `ringing`/`in_progress` for the calls in progress right now, to final statuses for completed records, or to any mix of the two. Use `from`/`to` for one known party number in international form, and `number` to search either side by fragment. These are per-call records: for rates and totals over a period use voice_stats_summary rather than summing them here, and voice_get to follow one call to settlement.

Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.

## Procedure

Step 1 of 8 of "Watch voice calls and find out why one was refused". Next: bird voice get.

## Examples

```bash
bird voice list
bird voice list | jq -r '.data[].id'
bird voice list --limit 50 --starting-after <cursor>
```

## Options

#### Filters

| Name                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--direction`        | Return only calls in this direction. Possible values: inbound, outbound.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `--from`             | Return only calls placed from this calling party number, matched as a whole number rather than as a fragment. Give it in international form: +14155551234, 14155551234, and 0014155551234 all select the same calls, because a call record keeps the number exactly as the calling equipment presented it. A number given without a country code matches only calls recorded in that same form, since it names a different number in every country. Use number instead to match part of a number, or either side of the call. |
| `--number`           | Return only calls where the calling or called number contains this value. Matches a partial number, so a country or area-code prefix returns every call to or from it. Combines with from/to, which match one side exactly.                                                                                                                                                                                                                                                                                                   |
| `--response-schema`  | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `--session-id`       | Return only calls belonging to this session, which is how the legs of one multi-party or transferred call are correlated.                                                                                                                                                                                                                                                                                                                                                                                                     |
| `--sip-trunk-id`     | Return only calls carried by this SIP trunk.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `--started-after`    | Return only calls that started at or after this instant, inclusive. RFC 3339 timestamp.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `--started-before`   | Return only calls that started at or before this instant, inclusive. RFC 3339 timestamp.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `--status <v1,v2,…>` | Return only calls with one of these statuses, comma-separated. In-flight and final statuses may be combined freely. Possible values: answered, no_answer, busy, canceled, failed, rejected, unknown, ringing, in_progress.                                                                                                                                                                                                                                                                                                    |
| `--to`               | Return only calls placed to this called party number, matched as a whole number rather than as a fragment. Give it in international form: +16505559876, 16505559876, and 0016505559876 all select the same calls, because a call record keeps the number exactly as the calling equipment presented it. A number given without a country code matches only calls recorded in that same form, since it names a different number in every country. Use number instead to match part of a number, or either side of the call.    |

#### Pagination

| Name               | Description                                                                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `--ending-before`  | Cursor from the prev_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. |
| `--limit <n>`      | Maximum number of items to return per page.                                                                                                    |
| `--starting-after` | Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.  |

## Related

| Name                                              | Description |
| ------------------------------------------------- | ----------- |
| [`bird voice get`](/docs/cli/reference/voice-get) | Get a call  |