bird voice list
Usage
Codebeispiel
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
Codebeispiel
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 | Get a call |