Skip to main content
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>"
}
'

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.

​
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