POST
/
buy-phone-number
curl --request POST \
  --url https://api.daily.co/v1/buy-phone-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "number": "+18058700061"
}'

This will buy a phone number. In the POST request you can either provide the phone number you want to buy, or leave it empty. If the specified number is still available, it will be bought or the API will return a failure. Alternatively, if you skipped the number field, a random phone number from California (CA) will be bought.

You can check or find available numbers using the /list-available-numbers API.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
number
string

The phone number to purchase. Example: '+18058700061'.

Response

200 - application/json
id
string

A UUID that uniquely identifies this phone number.

number
string

The purchased phone number.

List Available NumbersRelease a Phone Number