# Find and buy a new number

Numbers can be searched for and purchased directly in your MessageBird dashboard. Before you start the purchasing process, check that you have enough balance in your wallet.

{% hint style="info" %}
&#x20;API users can buy and provision numbers from their dashboard, or via the API.
{% endhint %}

### Find available numbers

With over 50 countries and 700 prefixes and area codes to choose from, selecting and purchasing a number might seem complicated, but you can use our number-purchasing wizard to make the process quick and simple by filtering available numbers directly in your dashboard.

1. Click on your name in the bottom left-hand side of your screen, then click **Settings**.\
   ![](/files/ivr38lOs4zP8MnPJiJDd)
2. Click the **Channels** tab at the top of your screen to view the channels library.<br>

   <figure><img src="/files/LsrtVsaadyAjrqHgNblv" alt=""><figcaption></figcaption></figure>
3. Select the number type you want to buy, then click **Buy a number**.
4. Click the **Country** field and enter the name of the country that you want to use the number for.
5. Click the **Type** dropdown and select the type of number you want to purchase.
6. Click the **Capabilities** dropdown and check the box next to the capabilities that you want the number to have.
7. \[Optional] Click the **Prefix** field to search numbers using specific area codes or prefixes.
8. Toggle the 2-way communication button on or off to filter numbers by direction (inbound or outbound, or inbound only).

Available numbers that match your criteria will be displayed on this page. Hover over the capabilities to see more information about them, or click **All details** to see full information about a number and its requirements.

To the right of the available numbers, you will be able to see the cost of the number per month.

### Purchase a new number

{% hint style="info" %}
You can buy up to 25 numbers in the same transaction.
{% endhint %}

To start the number-purchasing process, add one or more numbers to your cart.

Numbers that are added to your cart will be reserved for 30 minutes. If you don’t complete the purchase within 30 minutes of placing a number in your basket, the number will be returned to the inventory and made available for other customers to purchase.

1. Next to the number that you want to purchase, click **Add to cart**.
2. Click **Go to cart**.
3. Review the contents of your cart, and remove any numbers that you added but no longer want to purchase.
4. In the order summary pane, you can see the total number of numbers that you’re purchasing, the cost per month of purchasing those numbers, the VAT, and the order total.&#x20;
5. Click **Proceed to payment**.

To complete your purchase, the balance will be taken from the wallet that is assigned to your workspace, and the number(s) will be added to your workspace.

Depending on the type of number you choose, and the country you select, we may ask you to provide us with additional Know Your Customer (KYC) information to ensure that you comply with local regulations.

#### Remove a number from the cart

Numbers can be removed from your cart before purchase by clicking the **Remove from cart** button next to the number.

You can also remove a number by navigating to your cart, locating the number there, and clicking **Remove from cart**.

#### Purchase additional numbers

Once you’ve purchased your first number(s), you can buy a new number by going to **Channels** > **Your channels** > **Numbers** > **Buy a number**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/applications/channels/channels/supported-channels/numbers/quickstarts/find-and-buy-a-new-number.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
