# Buy a number

Phone numbers are bought in the portal under **Numbers**. Buying numbers needs **Tier 2** or higher (see [account-tiers.md](/md/account-tiers.md)).

## Search

1. Go to **Numbers** and select **Buy numbers**.
2. Pick a **Country** (United States or Canada) and a **Type**: **Local** or **Toll-free**.
3. Narrow the search:
   - Local: **State** (**Province** in Canada) or **Area code** (three digits). Picking one clears the other.
   - Toll-free: **Prefix** (800, 833, 844, 855, 866, 877 or 888), or **Any**.
   - **Match**: **Contains**, **Starts with** or **Ends with**, with the digits or vanity letters you want.
4. Select **Search**. Toll-free searches, and local searches with a state or province, run on their own.

Each result shows the number, its location, its type, its features, the monthly price and the setup price. Numbers without a price are never shown. **Rows** sets how many results show at once (25, 50, 100, 500 or 1000); **Load more** shows the next ones.

## Capabilities

Numbers are sold for **voice** today. Text messaging is not available on numbers yet.

## Cart and checkout

1. Select **Add** next to each number you want, or tick several numbers and select **Add selected**. The cart icon in the top bar shows the count.
2. Open the cart. It lists each number with its monthly and setup price, and the **Due today (setup + first month)** total.
3. Select **Checkout**.

The amount is charged to your account balance, then monthly after that. If the balance is too low, checkout stops with **Insufficient balance**. Top up first (see [balance-and-top-up.md](/md/balance-and-top-up.md)).

A new number shows status **Pending** until it is ready, then **Active**.

## Service address

Some countries need a local service address before a number can be ordered. Checkout then opens **Service address required**. Enter **Street address**, **City**, **State / region** and **Postal code**, and select **Save & continue**. The address is reused for your other numbers in that country.

Some addresses are checked by our team first. The order completes once the address is approved, and you get a notification.

## Common messages

| Message | What to do |
|---|---|
| Verify your email first | Open the link in the verification email, or resend it from the banner. |
| Buying numbers requires Tier 2 | Select **Account tier** and complete the next step. |
| Insufficient balance | Top up in **Settings > Billing**. |
| Your verification for this country is under review | Wait for the address review to finish. |

## Next

- [route-a-number.md](/md/route-a-number.md)
- [release-a-number.md](/md/release-a-number.md)
