POST
/
phone-numbers
/
buy
cURL
curl --request POST \
  --url https://api.bolna.ai/phone-numbers/buy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "country": "US",
  "phone_number": "+19876543210"
}'
{
  "id": "133b9a7d-59b1-49c4-b62a-c4924503e38b",
  "agent_id": null,
  "bolna_owned": true,
  "deleted": false,
  "renewal": true,
  "payment_uuid": "de36c363-6a2d-4e83-ba5b-fbb8d0ac8c32",
  "phone_number": "+19876543210",
  "price": 500,
  "telephony_provider": "twilio",
  "telephony_sid": "19876543210",
  "created_at": "2025-07-27T20:51:49.468787",
  "updated_at": "2025-07-27T20:51:49.468796"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Purchase a phone number

The body is of type object.

Response

200
application/json

Sub-account create response

The response is of type object.