band tfv submit

Submit a toll-free verification request

Synopsis

Submits a new toll-free verification request. All fields are required by the carrier ecosystem. Verification is reviewed by carriers and typically takes a few business days.

band tfv submit <phone-number> [flags]

Examples

  band tfv submit +18005551234 \
    --business-name "Acme Corp" \
    --business-addr "123 Main St" \
    --business-city "Raleigh" \
    --business-state "NC" \
    --business-zip "27606" \
    --contact-first "Jane" \
    --contact-last "Doe" \
    --contact-email "jane@acme.com" \
    --contact-phone "+19195551234" \
    --message-volume 10000 \
    --use-case "2FA" \
    --use-case-summary "Two-factor authentication codes for user login" \
    --sample-message "Your Acme verification code is 123456" \
    --privacy-url "https://acme.com/privacy" \
    --terms-url "https://acme.com/terms" \
    --entity-type "PRIVATE_PROFIT"

Options

      --business-addr string      Business street address (required)
      --business-city string      Business city (required)
      --business-name string      Legal business name (required)
      --business-state string     Business state, 2-letter code (required)
      --business-zip string       Business postal code (required)
      --contact-email string      Contact email (required)
      --contact-first string      Contact first name (required)
      --contact-last string       Contact last name (required)
      --contact-phone string      Contact phone in E.164 (required)
      --entity-type string        Business entity type: SOLE_PROPRIETOR, PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT (required)
  -h, --help                      help for submit
      --message-volume int        Estimated monthly message volume (required)
      --privacy-url string        Privacy policy URL (required)
      --sample-message string     Example message content (required)
      --terms-url string          Terms and conditions URL (required)
      --use-case string           Use case category, e.g. 2FA, MARKETING (required)
      --use-case-summary string   Brief summary of how the number will be used (required)

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 tfv - Toll-free verification management