bird voice list

Usage

Ejemplo de código

bird voice list [flags]

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 and do not include aggregate rates or totals. Use bird 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 9 of "Watch voice calls and find out why one was refused". Next: bird voice get.

Examples

Ejemplo de código

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. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. 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 <value>…	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.
--tag <value>…	Filter by tag. Accepts name to match any record carrying that tag name, or name:value to match a specific tag pair (for example category:welcome). Repeat the parameter to add more tags. A record must match every tag listed to be returned.
--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. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. 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 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.
--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
bird voice get	Get a call