band insights

Voice usage and quality aggregates (minutes of use, call counts, connection rates)

Synopsis

Read aggregated voice traffic data from the Bandwidth Insights API: minutes of use, completed and failed calls, connection rates, and average call durations — filterable by phone number, direction, call type, and sub-account.

Results are broken into time slices whose granularity scales with the requested window (hours for a few days, months for long ranges). History goes back at most one year. Defaults to the last 7 days when no time range is given.

Requires the Monitoring API feature on your account. If you get a 403 error, ask your Bandwidth account manager to enable it.

Options

  -h, --help   help for insights

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 - Bandwidth CLI — manage voice, messaging, numbers, and more from the command line
• band insights average-durations - Average call durations per time slice
• band insights completed-calls - Completed call counts per time slice
• band insights connection-rates - Call connection rates per time slice
• band insights failed-calls - Failed call counts per time slice
• band insights minutes-of-use - Aggregated minutes of use per time slice