band number list

List phone numbers on the account

Synopsis

Lists phone numbers on the active account.

By default, returns only numbers in service (ready to route calls or send messages). Pass --status to include numbers in other states.

band number list [flags]

Examples

  band number list                                # default: only in-service
  band number list --status Inservice,InAccount   # include numbers just ordered
  band number list --status Aging                 # numbers being released
  band number list --npa-nxx 919555                # in-service numbers in an NPA-NXX
  band number list --state NC --ratecenter RALEIGH # in-service numbers in a rate center
  band number list --subaccount 407                # numbers on a sub-account
  band number list --subaccount 407 --location 500017
  band number list --disconnected                  # recently disconnected numbers

Options

      --disconnected        List disconnected numbers instead of in-service ones
  -h, --help                help for list
      --lata string         Filter to a LATA (in-service numbers only)
      --location string     List numbers on a location (SIP peer ID); requires --subaccount
      --npa-nxx string      Filter to a 6-digit NPA-NXX prefix (in-service numbers only; requires the inservice role)
      --ratecenter string   Filter to a rate center; requires --state
      --state string        Filter to a 2-letter state/province (in-service numbers only)
      --status string       Comma-separated statuses to include. Common values: Inservice (live), InAccount (assigned, not yet live), Aging (released, in aging period). (default "Inservice")
      --subaccount string   List numbers on a sub-account (site ID)

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 number - Manage Bandwidth phone numbers