band portin list

List port-in orders on the active account

Synopsis

Searches port-in orders on the active account. Pagination is mandatory on the API side — defaults are page=1 size=30. Filters are AND-ed.

band portin list [flags]

Examples

  band portin list
  band portin list --status SUBMITTED --size 100
  band portin list --start-date 2026-01-01 --end-date 2026-04-01
  band portin list --customer-order-id agent-run-42

Options

      --customer-order-id string   Filter by customer-supplied order ID
      --end-date string            Latest last-modified date (YYYY-MM-DD)
  -h, --help                       help for list
      --order-tn string            Filter by one of the TNs being ported
      --page int                   Page number (pagination) (default 1)
      --pon string                 Filter by PON (purchase order number)
      --size int                   Page size (pagination) (default 30)
      --start-date string          Earliest last-modified date (YYYY-MM-DD)
      --status string              Filter by order status (DRAFT, SUBMITTED, FOC, COMPLETE, CANCELLED, etc.)
      --tn string                  Filter by billing TN

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)