band portin validate-tf

Check whether toll-free numbers can be ported

Synopsis

Submits a toll-free porting validation order and reports portability per number. Without --wait, returns the order in PROCESSING state and the caller polls separately. With --wait, blocks until the order reaches COMPLETE or FAILED.

When any number reports portable=false, this exits 1 with the per-number reason — the negative result is surfaced rather than buried in the response.

band portin validate-tf <number> [number...] [flags]

Examples

  band portin validate-tf +18005551234
  band portin validate-tf +18005551234 +18885551234 --wait --plain

Options

  -h, --help               help for validate-tf
      --timeout duration   Maximum time to wait (default 60s) (default 1m0s)
      --wait               Wait until validation reaches a terminal state (COMPLETE or FAILED)

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 portin - Manage port-in orders (single, bulk, toll-free)