POST
/
numbers
/
purchase
Purchase Phone Number
curl --request POST \
  --url https://api.bland.ai/numbers/purchase \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "area_code": "<string>",
  "country_code": "<string>",
  "phone_number": "<string>"
}'

​
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"