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

​
country
enum<string>
required

The country code for the phone number.

Available options:
US,
IN
​
phone_number
string
required

E.164 formatted phone number, including country code.

Example:

"+19876543210"

Response

Sub-account create response

​
id
string<uuid>

Unique identifier for the purchased phone number record.

Example:

"133b9a7d-59b1-49c4-b62a-c4924503e38b"

​
agent_id
string<uuid> | null

Identifier of the agent associated with the number, if applicable.

Example:

null

​
bolna_owned
boolean

Indicates if the number is owned by Bolna.

Example:

true

​
deleted
boolean

Indicates whether the number record is deleted.

Example:

false

​
renewal
boolean

Indicates if the phone number subscription will auto-renew.

Example:

true

​
payment_uuid
string<uuid>

Unique identifier for the payment transaction.

Example:

"de36c363-6a2d-4e83-ba5b-fbb8d0ac8c32"

​
phone_number
string

E.164 formatted purchased phone number.

Example:

"+19876543210"

​
price
number

Price for the phone number in cents.

Example:

500

​
telephony_provider
enum<string>

Name of the telephony provider for the number.

Available options:
twilio,
plivo,
vonage,
telnyx
​
telephony_sid
string

Unique identifier or SID for the phone number within the telephony provider.

Example:

"19876543210"

​
created_at
string<date-time>

Timestamp when the record was created.

Example:

"2025-07-27T20:51:49.468787"

​
updated_at
string<date-time>

Timestamp when the record was last updated.

Example:

"2025-07-27T20:51:49.468796"