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

# Phone Numbers

> Rent a local US or Canadian number in under a minute, check a number you already own, and make sure your campaigns can call leads in the US and Canada.

Your AI needs a number to call from. It's the number your leads see when their phone rings. You have three ways to get one, all from **Phone numbers**, then **Get a number**:

| Way | What it costs | How long it takes | Calls the US and Canada | Answers incoming calls |
| - | - | - | - | - |
| **Rent a local number** | \$4.99 a month from your credit | Under a minute | Yes, straight away | Not yet |
| **Use a number you own** | Free | A check call of about 2 minutes | Yes, after you turn it on | No, calls to it still ring at your phone company |
| **Connect your phone system (SIP)** | No line charge from us | Depends on your IT team | Yes, through your carrier | Yes, see [Inbound Calls](https://docs.topcalls.ai/guides/inbound-calls.md) |

Each of these can call other countries too. What a call costs depends on where you call, not on the number you call from: see [Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md).

## Rent a local number

Renting is for the US and Canada today. You need billing access in your workspace to rent. Anyone without it sees a note saying so, and can still use a number they own.

**1. Open Get a number**

Go to **Phone numbers** and select **Get a number**, then **Rent a local number**. You can also start from a campaign: when its leads include US or Canadian numbers and none of your numbers can call them, the campaign offers **Rent a local number** right where you pick your numbers.

**2. Pick where the number should be**

Choose the country, then search by area code or by city. When most of your leads share one area code, the search starts there. Add digits under **Number contains** if you want them in the number.

**3. Check the cost**

The box under the number shows what you pay now and what you pay each month after. The first month is charged by the day, for the days left in the month.

**4. Rent it**

Select **Rent** with the number shown. It is ready to call in under a minute, and you can put it on a campaign from the same screen.

Rented numbers are local numbers. Toll-free numbers aren't for rent.

### What a rented number costs

| | Price |
| - | - |
| A local number in the US or Canada | \$4.99 a month |
| The first month | Only the days left in the month |
| After that | \$4.99 on the 1st of each month |
| Calls from it | The normal price of the call: the AI plus the line of the country you call ([Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md)) |

The fee comes out of your credit. Your first rented number's first month comes out of your free starter credit when enough of it is left to pay the whole amount. Free credit never pays part of a fee. Every other fee is paid from credit you bought, so a second number needs purchased credit. A number keeps the price it was rented at.

### When your credit can't pay the fee

If your purchased credit can't cover a monthly fee, the number is paused. A paused number makes no calls. Add credit and it comes back on its own. If it stays unpaid for 30 days, the number is released and goes back to TopCalls. The people in your workspace who manage billing get an email 7 days before the release and another when it happens.

### Release a number you don't need

Open the number's menu on **Phone numbers** and select **Release**. A number that a running campaign calls from can't be released: pick another number for that campaign or stop it first. The month you've paid for isn't refunded, and you may not get the same number back.

### Limits

By default a company can hold up to 5 rented numbers at once, paused ones included. Ask support to raise the limit. TopCalls can also pause a rented number. Contact support to switch it back on.

### Numbers in other countries

Need a number somewhere other than the US or Canada? Select **Ask us** on the rent screen, enter the country, how many numbers you need and what for. We reply by email within 1 to 3 business days. Some countries ask for a business address or ID before a local number can be sold.

## Use a number you own

Your leads see a number they already know, and it's free. TopCalls calls the number once to check that it's yours.

**1. Enter the number**

Go to **Phone numbers**, select **Get a number**, then **Use a number you own**. Pick the country and type the number.

**2. Choose whether it calls the US and Canada**

Tick **Calls US & Canada** if you'll call leads with `+1` numbers. You then confirm two things: that you own the number or have the right to use it, and that your company has the consent the law requires for every call, including prior written consent from each person before any AI call to a US number (FCC 24-17). We save who agreed and when. We don't check your leads for consent.

**3. Answer the check call**

Select **Call me to check**. We call the number and show a code on your screen. Pick up and type the code on the phone's keypad. You can close the window while it runs: the number shows **Checking…** in your list until it's done.

A number can be checked in one TopCalls workspace at a time. To move it, remove it from the other workspace first. You can turn on US and Canada calling later from the number's row on **Phone numbers**.

## Calling the US and Canada

A call to a `+1` number (the US, Canada and the rest of North America) needs a number that's allowed to call there:

* a number you rented from TopCalls,
* a number you own that passed the check with **Calls US & Canada** on, or
* a number on your own carrier.

Each number's row on **Phone numbers** shows **Calls US & Canada**, **Calls other countries** and **Answers calls**, so you can see what it does before you use it.

Campaigns check this for you. When you pick numbers on a campaign's **How it dials** step, a **Before you launch** panel counts the US and Canada leads that no picked number can call, and offers a fix on the spot: rent a local number, or turn on US calling for a number you own. You can still launch without fixing it. Those leads are then skipped and keep their attempts, and every other lead is called as usual. The launch confirmation tells you how many will be skipped. Through the API, the same rule answers with the warning `us_leads_skipped`, or `422` with `us_caller_id_required` when nothing else could be called ([Campaigns](https://docs.topcalls.ai/concepts/campaigns.md#caller-id)).

## Numbers through the API and MCP

Renting and the check call happen in the dashboard. Once a number is on your account, it shows up in `GET /v1/phone-numbers` and in the `list_phone_numbers` MCP tool like any other number, and you can use it as `from_number` on a call or in a campaign.

## Related

* [Where TopCalls calls](https://docs.topcalls.ai/concepts/where-you-can-call.md): the numbers TopCalls won't dial, whatever number you call from.
* [Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md): what a minute costs by country.
* [Inbound Calls](https://docs.topcalls.ai/guides/inbound-calls.md): answer calls with an inbound campaign.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.