band insights completed-calls

Completed call counts per time slice

Synopsis

Completed call counts per time slice.

All filters are optional; unfiltered requests cover the whole account over the last 7 days. Phone-number filters accept comma-separated E.164 values and can be slow on large accounts — add other filters to narrow the scope.

band insights completed-calls [flags]

Examples

  band insights completed-calls
  band insights completed-calls --to +18005551234 --since 30d
  band insights completed-calls --call-type TOLLFREE-IN --direction INBOUND --since 2026-07-01T00:00:00Z

Options

      --call-type string    Filter by call type (e.g. TOLLFREE-IN, TOLLFREE-OUT, LOCAL, INTERSTATE)
      --direction string    Filter by call direction: INBOUND or OUTBOUND
      --from string         Filter by originating number(s), comma-separated E.164
  -h, --help                help for completed-calls
      --since string        Start of the time range: RFC3339 or relative (e.g. 30d, 24h, 90m); default 7 days ago
      --subaccount string   Filter by sub-account ID
      --to string           Filter by destination number(s), comma-separated E.164
      --until string        End of the time range: RFC3339 or relative; default now

Options inherited from parent commands

      --account-id string    Bandwidth account ID (overrides config)
      --environment string   API environment: prod, test (overrides config)
      --format string        Output format: json or table (default "json")
      --plain                Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO

• band insights - Voice usage and quality aggregates (minutes of use, call counts, connection rates)