band message list

List messages with optional filters

Synopsis

Lists message metadata with optional filters by recipient, sender, and date range. Note: Bandwidth does not store message content — only metadata is returned.

band message list [flags]

Examples

  # Filter by sender
  band message list --from +15559876543

  # Filter by date range
  band message list --start-date 2024-01-01T00:00:00.000Z --end-date 2024-01-31T23:59:59.000Z

Options

      --end-date string     Filter messages before this date (e.g. 2024-01-31T23:59:59.000Z)
      --from string         Filter by sender phone number
  -h, --help                help for list
      --start-date string   Filter messages after this date (e.g. 2024-01-01T00:00:00.000Z)
      --to string           Filter by recipient phone number

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 message - Send and manage SMS/MMS messages