> ## 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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Body

<ParamField body="area_code" default="415" type="string">
  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.
</ParamField>

<ParamField body="country_code" default="US" type="string">
  Choose a country code for your phone number.

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

<ParamField body="phone_number" type="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"`
</ParamField>

***

Docs for agents: [llms.txt](/llms.txt)