bird voice calls list [flags]
List the workspace's calls, newest first by the initial leg's start. A call groups its initial leg and any legs added by forwarding or dialing, and parties lists who took part. Use search for a fragment of a call ID or phone number, and has_recording/has_transcript to find calls that produced that content. Filters apply after reading, so a narrow search over a long history can time out; this list has no time-range filter, so use bird voice legs list with started_after/started_before to find calls in a window, then its call_id. A call placed with bird voice calls create appears only after its initial leg registers. Use bird voice calls get for one call and bird voice legs list with call_id for its legs.
Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.
bird voice calls list
bird voice calls list | jq -r '.data[].id'
bird voice calls list --limit 50 --starting-after <cursor>
| Name | Description |
|---|
--ending-before | Cursor from the prev_cursor or refresh_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev_cursor returns the preceding page. refresh_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since. |
--limit <n> | Maximum number of items to return per page. Allowed range: 1 to 100. |
--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. |
| Name | Description |
|---|
--has-recording | Filter by whether a call produced a recording at some point. |
--has-transcript | Filter by whether a call produced a transcript at some point. |
--response-schema | Print the fields this command returns, then exit |
--search | Search call IDs, party addresses and forwarded-to addresses. |