> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surge.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Toll-Free Verification

> How toll-free number verification works on Surge and how it differs from standard 10DLC local number registration.

Toll-free numbers (8xx area codes) go through a separate verification process from standard 10DLC local number registration. The two processes are independent — you can have both a local campaign (10DLC) and a verified toll-free number on the same account.

<Note>
  Surge can purchase numbers in `833`, `844`, `855`, `866`, `877`, and `888` via API. The original `800` prefix is mostly exhausted — Surge can port in an existing `1-800` number on request, but new purchases use one of the other prefixes.
</Note>

## Toll-free vs 10DLC

|                      | Toll-free verification                        | 10DLC (standard)                                             |
| -------------------- | --------------------------------------------- | ------------------------------------------------------------ |
| **Number type**      | Toll-free (8xx area codes)                    | Local 10-digit numbers                                       |
| **Daily throughput** | No T-Mobile daily cap                         | Capped at 2,000 SMS segments/day to T-Mobile on `low` volume |
| **Registration**     | Per-number verification                       | Brand + campaign, then attach numbers                        |
| **API support**      | Purchase via API; verification dashboard-only | Full API support                                             |

## How to verify a toll-free number

<Steps>
  <Step title="Purchase a toll-free number">
    `POST /accounts/{account_id}/phone_numbers` with `type: "toll_free"`. This part has full API support.
  </Step>

  <Step title="Open the verification form in the dashboard">
    Navigate to **Phone Numbers** and find the number you just purchased.
  </Step>

  <Step title="Click Verify">
    Opens the toll-free verification form.
  </Step>

  <Step title="Complete the form">
    Provide your business information, opt-in description, and sample messages.
  </Step>

  <Step title="Submit and wait for carrier review">
    The number is marked as verified once the carrier approves. Until then, throughput is restricted.
  </Step>
</Steps>

## Changes-needed on toll-free

<Note>
  If the carrier requests changes, Surge sends you a notification with details. Use the verification form in the dashboard to update and resubmit. The issues reviewers flag for toll-free are similar to 10DLC — opt-in flow clarity, business identity, and sample message quality. See [Avoiding Rejection](./avoiding-rejection) for the full breakdown.
</Note>

## API support

<Info>
  **Today:** purchasing toll-free numbers via API is supported.
  **Coming:** full toll-free verification via API. Until it ships, use the dashboard for the verification step.
</Info>