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

# Purchase Phone Number

> Purchase a new phone number (inbound/outbound). ($15/mo. subscription using your stored payment method).

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body

**area\_code** `string` (default: 415)

Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact match if available.

**country\_code** `string` (default: US)

Choose a country code for your phone number.

Options: `"US"` or `"CA"` for Canada. For others, please contact support.

**phone\_number** `string`

Specify an exact phone number you'd like to use. If provided, will override the `area_code` parameter and does not fall back to any other number.

Example of the correct format (Note the `"+1"` is mandatory): `"+12223334444"`

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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