band tendlc number list

List 10DLC registered phone numbers

Synopsis

Lists the phone numbers registered for 10DLC traffic on the account.

There is no --status flag. That is deliberate and measured, not an oversight: status[eq] and status[contains] are both accepted and silently ignored, for every value tried -- including a value matching nothing at all -- and every one of them returned every phone number on the account regardless. A filter that returns every record with a 200 and no error is worse than an absent flag, because the caller believes it worked -- the same reasoning that already removed 'brand list --bandwidth-id' and 'campaign list --usecase'.

--campaign-id-contains, by contrast, genuinely narrows results: campaignId[contains] filters correctly. campaignId[eq] does not -- like status, it is accepted and silently ignored, returning every number regardless of value -- which is why the flag is named for what it actually does (a substring match) rather than implying an exact-match filter the API cannot perform. For the campaign-scoped view, which is a different endpoint, use 'band tendlc campaign numbers ' instead.

The list projection has two shapes, not one fixed set of keys: every record carries createdDate, modifiedDate, nnid, phoneNumber, and status; a number already assigned to a campaign additionally carries brandId, campaignId, and customerProfileId. Do not assume every record is missing the campaign fields -- check for them rather than relying on their absence.

band tendlc number list [flags]

Examples

  band tendlc number list --plain
  band tendlc number list --all --plain
  band tendlc number list --campaign-id-contains CEXMPL1 --plain

Options

      --all                           Fetch every page (cannot be combined with --offset)
      --campaign-id-contains string   Filter by campaign ID substring (e.g. CEXMPL1 also matches CEXMPL12); the API has no exact-match operator for this field
  -h, --help                          help for list
      --limit int                     Page size (default 50)
      --offset int                    Pagination offset

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 tendlc number - Manage 10DLC phone number registrations